Tansi Platform — Master Manual
The complete Tansi reference: every module, every screen, every setting. Use the search bar at the top to jump straight to any term across the whole platform.
My Profile
Your own record in Tansi — who you are, what you are qualified to do, and the settings that control who can see it.
Before you start
My Profile is your own record in Tansi. It holds who you are, how to reach you, the tickets and certificates you hold, where you have worked, and the settings that decide who else can see any of it. Everyone who can sign in to Tansi has one.
The same page does a second job. Administrators, HR staff and managers open other people's profiles from the same address to check a certificate, fix a phone number, grant a role or suspend an account. So roughly half of what follows will never appear on your screen, and that is normal.
Who this module is for
| Reader | What this module gives you |
|---|---|
| Any signed-in person | Your own profile: the Dashboard, Overview, Qualifications, Resume Builder, Employment and Settings tabs, plus changing your sign-in email and password. |
| An employee of a company in Tansi | All of the above, plus the Duties tab and the employer's view of your qualifications, once you pick that company in the header picker. |
| HR | Other people's profiles, employee records, and approving or rejecting their qualifications. |
| Administrator or Developer | Everything above, plus the Roles and Account tabs for anyone in the workspace you are signed in to. |
What access you need
- A Tansi sign-in. The page itself asks for nothing more than that.
- A candidate profile if you want the Resume Builder, the Looking for Work card or the Qualifications list to show anything.
- An employee record at a company if you want the Duties tab and the employer's view of your requirements.
- The Admin or Developer role, in a real workspace, for the Roles and Account tabs. HR alone is not enough for those two.
Access to somebody else's profile is wider than most people expect. You can open a colleague's profile read-only if you share any workspace with them at all. Admins and HR can open anyone in their current workspace, and Developers can open anyone. Being able to open a profile is not the same as being able to change it: the banner at the top of the page tells you which you have, with a chip reading either Edit Access or View Only.
Several controls on another person's profile act on your own account rather than theirs: the Actively Looking and Public Profile switches, Upload Photo, Change Photo and Remove Photo, the Your Signature pad, and the Verify Now button on the phone warning. Each one reports success and flips on screen, so nothing tells you it went to the wrong record.
The safe route is the pencil beside the person's name, which opens the Personal Information dialog. Edits made there land on the person whose profile you are looking at. This is explained again, in place, in the Overview, Settings and Account sections.
How long this takes
Reading your own profile end to end takes about ten minutes. Setting it up properly — photo, personal information, phone verification, a few qualifications with their documents attached — takes about half an hour the first time.
Glossary
Tansi uses a handful of words in a particular way. Learning them here saves guessing later.
| Term | What it means |
|---|---|
| Workspace | One organization's area of Tansi. Your roles, your colleagues and most of your data belong to a workspace. The profile menu's Switch workspace item moves you between them. |
| Candidate profile | The job-seeker side of your record: resume, occupations, job matching. Without one, the Resume Builder, the Looking for Work card and the Qualifications list have nothing to show. |
| Employee record | Your record at one specific company: job title, department, hire date, salary, duties. One person can have several, one per employer. |
| Employee mode | What the profile page is in once you pick a company in the header picker and that person has a current job there. It adds the Duties tab and unlocks the FOIP-protected fields. |
| Qualification | Anything you hold that an employer might require: a ticket, a certificate, a licence, a skill. Tansi also calls these requirements when an employer is the one asking for them. |
| Qualification template | A pre-written qualification kept by Tansi, so that everyone records the same ticket the same way. Choosing one fills in the name and classification for you. |
| Class / Type / Sub-type | The three levels that categorize a qualification. Type is filtered by the Class you pick, and Sub-type by the Type. |
| Approve / Reject / Bypass | What an employer does with a qualification you have claimed. Bypass means the requirement does not apply to this particular job, rather than that you failed it. |
| Reset status | Sends an approved, rejected or bypassed qualification back to pending so it can be looked at again. |
| Company-level and project-level approval | An employer can approve your qualification for the whole company, or only for one project. The Project Filter (Optional) picker switches between the two views. |
| Verified / Unverified | A job Tansi can confirm from an employer's own records is Verified. A job you typed into your resume yourself is Unverified. Both show on the Employment tab, in separate sections. |
| FOIP | Freedom of Information and Protection of Privacy. In Tansi it marks the fields that are hidden from employers until a candidate is hired: emergency contact, gender and self-identification. |
| Self-identification | The voluntary statement of Indigenous identity, visible-minority status or neither, used for employment equity. Always optional. |
| NOC code | The Canadian National Occupational Classification number for a job, such as 72200. Tansi matches job alerts by NOC group. |
| Kebab menu | The three-dot button in the corner of a qualification card. Its contents change with what you are allowed to do, and it disappears entirely when you are allowed to do nothing. |
| Account status | Where a sign-in account sits in its lifecycle: Invited, On hold, Active, Suspended or Decommissioned. |
| Public store | An optional public page listing the courses and webinars you have published publicly. It has its own short handle in the web address. |
| Idle timeout | The countdown overlay that appears when you have left Tansi untouched for too long. It cannot be dismissed; you either stay signed in or sign out. |
Finding your profile, and the two pickers at the top
Your profile lives at /my-profile. Get there from the avatar in the top right of any page, then My Profile. Somebody else's profile is the same address with their user id on the end, which is how Tansi links to it from employee lists and search results — you rarely type it.
Three things you might see before the page draws
While the record loads you get a spinner and Loading profile.... If something went wrong fetching it you get Unable to load the profile. Please try refreshing the page., and refreshing is genuinely the right move. There is a third state, You don't have permission to view this profile., but you will almost never see it sitting on screen: Tansi shows it as a brief message and sends you back to your own profile instead. If you clicked a link to a colleague and landed on yourself, that is what happened.
Viewing somebody else
When the profile is not yours, a blue banner across the top reads You are viewing {name}'s profile. and carries a chip reading Edit Access or View Only. Check that chip before you plan any changes. Note also that the browser tab is titled Profile - {name} rather than My Profile, which is a quick way to tell two open tabs apart.
The company picker
Above the header card sits a picker labeled View Profile As on your own profile, or View Employee Profile As on someone else's. It appears only when there is something to choose: at least one employee record that you are allowed to see. Picking a company tells Tansi to show you this person as that company sees them.
That is a bigger change than it sounds. Picking a company:
- adds the Duties tab, if the person currently works there;
- switches Qualifications to that employer's requirement list, with approval status and the approve, reject and bypass actions;
- unlocks the FOIP-protected fields — emergency contact, gender and self-identification — for an HR or manager viewer who could not see them a moment ago;
- puts chips beside the picker for the job title, the workspace name, Current, the project role, Manager and Can Approve.
On your own profile the picker also offers Personal Profile. Choosing it clears the company and returns you to the plain, employer-free view. Because clearing the picker also takes the FOIP fields away again, the Self-Identification tab can vanish part-way through a session; that is the picker, not a fault. Switching company reloads the profile and resets the Qualifications, Duties and Projects lists.
An administrator looking at somebody with no shared employers gets This user does not have any employee records in companies you have access to. instead of a picker.
The project picker
Once a company is chosen, and that person has project assignments there, a second picker appears labeled Project Filter (Optional). Its help text says what it is for: Select a project to view project-level requirement approvals. This is in addition to company-level approvals. Use it when a single project demands tickets the company as a whole does not. Changing it reloads only the Qualifications list, so it is a cheap thing to try.
Links that open the page in a particular state
| What is on the end of the address | What it does |
|---|---|
| ?tab= | Opens the page with that tab already selected. Tansi uses it in its own links and emails. |
| ?jobId= | Adds a Job Match card above the header, scoring this person against that job. |
| ?requirementTemplateId= | Opens the Add Qualification dialog straight away, filled in from that template. |
A ?tab= value that does not match a real tab leaves the page body blank with nothing highlighted in the tab strip. Nothing is broken — click any tab name to recover. The same brief blankness happens if the tab you are standing on stops applying, for instance when you clear the company picker while you are on Duties.
The Job Match card
When a link carries ?jobId=, a card appears above the profile showing the job title, an overall {n}% Match chip with a progress bar, and a Match Breakdown across six factors: Skills, Tickets, NOC Code, Location, Indigenous and Requirements. A factor that does not apply to this job reads N/A. Below that are two lists, Met Requirements ({n}) and Missing Requirements ({n}). If the job cannot be found you get The referenced job could not be found.
On someone else's profile, when they have a candidate record and have either not applied or are sitting at Invited, the Job Match card also carries an Invite to Apply button, or Resend Invite if you have already asked once. The button is not there on your own profile.
As soon as you type anything anywhere on My Profile, Tansi flags the page as having unsaved work. If the idle-timeout countdown appears, it adds an amber line warning you about it.
Two things to know. First, that flag is almost never cleared — saving your work does not reliably clear it, so the warning tends to keep appearing for the rest of the session even when everything is saved. Second, the warning does not extend the countdown by a single second. When the overlay appears you have two ways out, Keep me signed in and Sign out now, and there is no close button, no Escape and no clicking the background. Save before you walk away.
The Dashboard tab
Dashboard is the first tab, and it is the one you land on when you open your own profile without a link telling Tansi otherwise. It exists only on your own profile; there is no Dashboard on anybody else's.
The heading reads My Dashboard, and under it: Drag a widget's title bar to move it, or drag its edges to resize — your layout is saved automatically. There are two windows floating on an open canvas:
- Notifications — a condensed view of the same list you get at /my-notifications. Newest first, one notification per person per alert, and an alert that no longer applies is cleared for you rather than left to pile up.
- My Tasks — the tasks assigned to you.
Each window has a maximize and restore control in its title bar, a title bar you can drag to move it, and edges you can drag to resize it. These two windows are all there is today — there is no button for adding a third.
The caption says your layout is saved automatically, and it is, but it is saved by your web browser rather than by your Tansi account. Sign in on a different computer, use a different browser, or clear your browsing data, and the windows go back to where they started. Nothing else is lost, so this costs you a few seconds of dragging rather than any real work.
The Overview tab
Overview is the summary of the whole profile, and it is the tab you land on when you open somebody else's. It is a grid of cards, and a card whose data does not exist is left out rather than shown empty. If you cannot find a card described below, that is usually the reason.
Looking for Work
This card appears only for people with a candidate profile. It reads either Your profile is visible to recruiters or Your profile is hidden from recruiters, and carries one switch. Flipping it toasts Your profile is now visible to recruiters or ...now hidden from recruiters. The same setting appears again as Actively Looking on the Settings tab.
Administrators and Developers see this switch enabled on every profile they open, but the switch is wired to the signed-in account, not to the person on screen. Flipping it on a colleague's profile changes your visibility to recruiters, shows a success message, and flips the switch on screen as though it had worked.
The same is true of the Public Profile switch on Settings, Upload Photo, Change Photo, Remove Photo, the Your Signature pad and Verify Now.
There is one route that always edits the right person: the pencil beside their name, which opens the Personal Information dialog. If you need someone's visibility, photo or signature changed, ask them to do it on their own profile.
Qualifications Summary
Four numbers — Total, Active, Expiring and Expired — drawn from the Qualifications tab. The card appears only once there is a summary to show. Treat Expiring as your to-do list.
Contact Information
Always present. The pencil in its corner opens the Personal Information dialog.
| Row | What to know |
|---|---|
| Email: | On your own profile only, a Change button sits beside it, with the tooltip Change your sign-in email. This is deliberately kept out of the Personal Information dialog, because the address is also your sign-in. See the section on changing it. |
| Phone: | A green tick with the tooltip Phone number verified once the number is confirmed. |
| Phone not verified | A warning strip with a Verify Now button, shown whenever a number exists but has not been confirmed. Verifying matters more than it looks: an unverified number locks almost the whole application at your next sign-in. |
| Location: | Reads Not provided when empty. |
| Date of Birth: | Shown only when it is set. |
| Emergency Contact | A small block with Name: and Phone:. It is FOIP-protected, so it appears on your own profile, or on an employee's profile once you have picked their company. |
The Verify Now button on the phone warning strip has no check for whose profile you are on. It sends the code to the number shown — the other person's — but the verification itself is applied to your account. The colleague gets an unexplained text message and their number stays unverified.
Phone verification is something each person does on their own profile, or at the sign-in gate that will appear for them anyway.
Your Signature
Shown only to someone who can edit the profile. The pad has two tabs, Draw and Upload. Draw gives you Clear and Save Signature; once saved the card reads Signature saved and offers Remove, which confirms with Signature removed. Upload takes an image file through Upload Image, up to 2 MB. As with the switches above, this pad writes to your own account even when you are looking at someone else.
Current Employment
Appears when the person currently holds a job in Tansi. It shows the job title, the company, Since {Month Year}, and chips for the employment status, the employment type and {n} Duties.
Professional Summary
Your own few lines about yourself, shown only when they are not empty, with a pencil that opens the Personal Information dialog. Tansi renders this exactly as it is stored, formatting and all. Text pasted from Word or a web page keeps its bold, bullets and sometimes its odd spacing, so check how it looks after pasting.
Your profile photo
The avatar at the top of the page shows your photo if you have one, and your initials if you do not. The pencil on the avatar offers Upload Photo (or Change Photo when one is already there) and Remove Photo. Uploading opens Edit Profile Picture, which says Upload your photo, then use the tools to zoom, crop, rotate, or flip before saving. The limit on that route is 5 MB, and the saved image is a JPEG.
Editing your personal information
Almost everything about a person is edited in one dialog, Personal Information. Several pencils open it: the one beside the name, the one on the Contact Information card, the one on Professional Summary, the one on Self-Identification (which opens straight at that section) and the one on Gender (likewise).
This is also the dialog administrators should use. Unlike the switches, the photo and the signature pad, it genuinely saves to the person whose profile you are on.
How to move around it
Across the top is a row of clickable chips: Basic Info, Address, Emergency Contact, Self-Identification and, where your workspace collects it, Gender. You can click a chip to jump straight to a section. At the bottom are Previous, Cancel and then either Next or, on the last section, Save, which reads Saving... while it works.
Section by section
| Section | What it holds |
|---|---|
| Basic Information | First Name and Last Name (both required), Middle Name, Date of Birth (required, and it will not accept a future date) and Phone Number (required). |
| Address Information | A single address box that completes as you type and fills in street, city, province or state, postal code and country for you. It is required. |
| Emergency Contact | Emergency Contact Name and Emergency Contact Phone, both required. |
| Self-Identification | Voluntary. Covered in its own section of this module. |
| Gender | Optional, and present only where the workspace collects it. Also covered later. |
Next will not take you out of Emergency Contact until both the name and the phone number are filled in. You get a message saying Emergency contact name is required before continuing. or Emergency contact phone is required before continuing. rather than a red field, so look at the top of the screen if Next appears to do nothing.
If you have no emergency contact to give, the chips at the top let you jump past this section and press Save from a later one. That works. It is also the only way through.
When you save personal information and the phone number has changed, Tansi closes this dialog and immediately opens phone verification — which sends a code to the new number the moment it appears. Correcting a single digit is enough to set that off, so do not be surprised by the text.
Finish it if you can. If you cancel, the new number is saved but unverified, and at your next sign-in Tansi will hold you at a verification screen with almost the entire application hidden until the number is confirmed.
Verifying a phone number
The verification dialog sends the code as it opens, shows We sent a code to {number}, and waits for six characters in the Verification code box. The code lasts ten minutes. Resend code is available after a 60-second cooldown, which counts down on the button itself. Verify stays unavailable until exactly six characters are entered.
It is worth doing properly the first time. Until your number is confirmed, Tansi replaces the whole application with a single card: no navigation, no workspace selector, no messages, no help centre, and nothing in the top bar but a sign-out icon. The card offers Verify now, Edit number and Sign out, and it clears itself the moment the number is confirmed.
On saving, Tansi confirms with Personal information updated successfully and reloads the profile behind the dialog.
Qualifications: seeing them and adding them
Qualifications is the list of tickets, certificates, licences and skills you hold. It is the tab employers care most about, and the one worth keeping current. While it loads you see Loading qualifications...
Four ways to look at the same list
Four small icon buttons at the top left switch the view. Hover each for its name: Card view (the default), Tile view, Table view and Kanban view. Table view is the fastest way to scan expiry dates; kanban groups by approval state. Your choice lasts for this visit only — the tab opens in card view again next time.
Each card carries the qualification name, Issued on, Expires on and Provider, and below those any approval detail: the template it was approved as, a rejection reason, a bypass reason or notes.
If this tab is empty and you expected entries, check whether the person has a candidate profile. Without one, Tansi has nothing to list here and does not explain why — the tab is simply blank. The Resume Builder tab is the honest one: it tells you outright and offers a button to fix it.
Qualifications and Duties are fetched the first time you open the tab and then kept for as long as the page stays open. A change you make in another browser tab will not appear here until you reload the page or change the company picker. The Account tab is the exception — it re-reads the record every time you click it.
Adding a qualification
Add Qualification sits at the top right, for anyone who can edit the profile. In card view each category can also carry its own Add button.
The button opens the AI-assisted dialog first. It offers three ways in: upload a photo or scan of the document, use your camera, or describe the qualification in your own words. If you would rather type everything yourself, choose Enter Details Manually and you get the classic form.
The manual form
For a new entry the form starts with Search qualification by name. Type a few letters and Tansi offers matching templates with their Class, Type and Sub-type as chips. If nothing matches you are told No matching qualifications found — fill in details manually below.
Choosing a template is the quick path, but it locks four fields: Name, Class, Type and Sub-type all become read-only. If you need to word the name differently, clear the template search first.
| Field | Required? | Notes |
|---|---|---|
| Name | Yes | Locked when a template is chosen. |
| Class | Yes | The broad category. Changing it changes the form — see below. |
| Type | No | Filtered to the Class you picked. |
| Sub-type | No | Unavailable until a Type is chosen. |
| Description | No | |
| Number/Reference | No | The certificate or licence number. |
| Issuing Authority | Yes | Who issued it. |
| Issue Date | Usually | Cannot be in the future. |
| Expiry Date | Usually | Cannot be in the past. |
| Never Expires | Switch | Turning it on removes the expiry requirement. |
| Notes | No |
The form changes shape for one class. When you pick Skills, the Issue Date, Expiry Date and Never Expires controls are not shown at all and none of the date rules apply. A skill is something you have, not something that was issued on a date, so there is nothing to fill in.
Saving checks the fields in a fixed order and stops at the first problem: issuing authority, then issue date present, then issue date not in the future, then expiry date present or Never Expires ticked, then expiry date not in the past. Fix them in that order and you will not go round twice.
Attaching documents
Under Supporting Documents, the Add Documents (PDF, Images) button takes PDF, JPG, PNG, GIF and WebP files, up to ten files per selection and 10 MB each. Files already attached are listed with their size and a red remove icon; new ones wait under New files to upload: until you save.
If the qualification has no physical document behind it, the dialog suggests If this requirement does not have a physical document, select 'Add Example' below to input text-based evidence instead. Add Text-Based Evidence opens a Text Evidence / Examples box for pasted code samples, written work or a description of your experience.
If you select ten files and three are over 10 MB or of a type Tansi does not take, the other seven are added and the three are left out. You get one message per rejected file, but nothing in the attachment list marks the gap.
Count the files in New files to upload: against what you selected before you press Save.
Each image you attach opens the Edit Scan editor before it joins the list, with the instruction Use the tools to zoom, crop, rotate, or flip the image to show only the relevant information. Pick three photos and you will do this three times in a row.
It is worth the time: cropping to the certificate itself makes approval quicker. If you have the document as a PDF, attaching that instead skips the editor altogether.
Save reads Uploading... while the files go up. Leave the dialog open until it finishes.
Browsing the template catalog
Browse Templates in the profile header opens the full catalog for anyone with a candidate profile. Filter with Search templates, Class, Type and Sub-type, each narrowing the next, with a running count of Showing {n} of {m} templates. Each card shows the name, its chips, a short description, Valid for {n} months where the template has a standard validity, and an Add to Profile button.
Deleting one of your own
Delete on the kebab menu asks first, with Confirm Deletion and Are you sure you want to delete '{name}'? This action cannot be undone. It means it — there is no undo and no recycle bin.
Qualifications: the kebab menu, approvals and removal
Every qualification card has a three-dot kebab button in its corner. What is inside it depends on who you are, whether a company is selected, and what that employer has already decided about this entry. When none of the actions applies, the button is not drawn at all — an empty menu is never shown.
| Menu item | Who gets it |
|---|---|
| View | Anyone who can see the entry. Opens it read-only. |
| Edit | Anyone who can edit this profile, when the entry itself allows editing. |
| Delete | Same as Edit. Asks for confirmation and cannot be undone. |
| Approve | An approver, in employee mode. There must be a company selected. |
| Reject | An approver, in employee mode. |
| Bypass | An approver, in employee mode. |
| Reset status | An approver, in employee mode. |
| Remove | HR, Admin or Developer, in employee mode. This takes the requirement off the employee rather than deleting the qualification. |
The approval actions appear only when a company is picked in the header, because approval is something an employer does. Pick the project too, and the same actions apply at project level instead; the confirmation messages say which, for instance Requirement approved at project level. against Requirement approved successfully. If you have no approval permission at this company you still see the qualifications, as a plain list with no actions on them. On your own profile you always see the company-level approval state of your own entries.
Approving
Approve Requirement asks Approve {name} for this employee? and then offers an Approve As (Optional) block: Optionally map this requirement to an approved template. Select "Add to Approved List" to create a new template from this requirement. Your choices are:
- tick Add to Approved List (create new template from this requirement) to turn this entry into a reusable template, and the button becomes Approve & Add to Templates;
- search for and pick an existing template in Approve As Template, and the button becomes Approve As Template;
- choose -- No template (approve as-is without mapping) -- and the button stays Approve.
Where the name and category match an existing template exactly, Tansi pre-selects it for you. There is a free-text Notes (Optional) box either way, and what you write there shows on the card afterwards.
Rejecting and bypassing
Reject Requirement needs a Reason for Rejection; the Reject button stays unavailable until you write one. The reason is shown to the person on their own card, so write it for them to read.
Bypass Requirement asks Mark {name} as not applicable for this employee's role? and explains itself: Bypassing a requirement indicates it's not relevant for this specific employment. The requirement will be marked as bypassed rather than approved or rejected. A Reason for Bypass is required here too. Use bypass when the job does not need the ticket, not when the person does not have it.
Delete and Remove both ask before they act. Reset status does not. One click sends an approved, rejected or bypassed qualification back to pending, with a single message reading Approval status reset to pending.
The approval itself has to be done again by someone with permission, so a stray click on a busy list costs real time. Move carefully in that menu.
Removing a requirement from an employee
Remove is for HR, Admins and Developers. It opens a dialog that asks how far the removal should cascade, and it declines with a message if there is no employee context, no permission, or no active workspace. Removing takes the requirement off this employment; the qualification stays on the person's profile.
Resume Builder
Resume Builder embeds the full resume editor inside the profile page, so you can work on your resume without leaving your record. It is the same builder you reach at /resume-builder, and the Edit Resume button in the profile header jumps straight to this tab.
If the tab shows a message instead
The builder needs a candidate profile behind it. Where there is none, the tab shows Please complete your candidate profile to access the Resume Builder. with a Complete Profile button that takes you to /candidate/personal-information. Fill that in and come back; the builder will be here.
This is worth fixing even if you are not job hunting. The same candidate profile is what gives you the Looking for Work card, the Qualifications list and the NOC occupations behind job alerts.
Jobs you add in the Resume Builder appear on the Employment tab under Self-Reported Work Experience, and the NOC codes attached to them seed the occupation list in your job alert settings. Removing a NOC code from job alerts does not change your resume.
Employment: verified and self-reported
The Employment tab holds two different things that look similar at a glance. Keeping them apart is the point of the tab.
Verified employment
These are jobs Tansi can confirm, because an employer entered them in Tansi itself. Current jobs come first, then the rest by hire date, newest first. Each card carries a Verified chip with the tooltip Verified by Tansi, a Current chip where it applies, and the detail an employer keeps: Department:, Position:, Employee ID: {n}, the date range (ending in Present for a current job), chips for employment status and type, {n} Duties, {n} Verified, and Workspace: {name}.
View Details opens the employee record read-only. HR, Admins and Developers also get Edit Employee, which opens the same dialog with the fields unlocked.
Self-Reported Work Experience
Below that is everything the person typed into their own resume, under the caption Added via Resume Builder — not verified by Tansi. Each entry carries an orange Unverified chip whose tooltip says so plainly: This entry was self-reported and has not been verified by Tansi. Entries show the location, the date range, an employment type chip, a NOC chip reading NOC {code} - {title}, the job duties and Achievements:.
On your own profile you get two buttons here: Add Experience, which opens a small dialog without leaving the page, and Edit in Resume Builder, which takes you to the full editor. The job duties are stored with their formatting intact, so anything pasted from another document arrives with its bold and bullets — check how it reads afterwards.
A verified job's type chip reads Full Time. A self-reported entry inches below reads Full-Time. They are not the same list and they are not a typo.
The difference is clearer in French and Spanish, where a verified Contract is Contrat or Contrato — the contractual arrangement an employer records — while a self-reported one is Contractuel or Por contrato, describing how the person worked. Read each chip in the context of the section it is in, and do not try to match them up.
If the tab is empty
With neither kind of history you get No Employment Records and Your employment history will appear here once you're hired or you add work experience in the Resume Builder. On your own profile there is an Add Work Experience button beneath it.
HR, Admins and Developers see an Add Employee button at the top of this tab for anyone who has a candidate profile. It opens the new-employee form with that candidate already attached, which is how a job applicant becomes an employee record.
The employee dialog itself has one dialog in two modes. View mode is read-only with a Close button and, for those who may edit, an Edit button that unlocks it. It covers Employment Details (Employee ID, Job Title, Department, Position), Employment Type and Status, Compensation (Salary and Salary Type), Dates (Hire Date, Start Date, End Date — leave End Date empty for a current employee), Reporting (Reports To and an Active Employee switch) and internal Notes. Job Title is the one required field in edit mode.
Duties
Duties is the only tab that is not always there. It appears when a company is selected in the header picker and the person currently works at that company. No company selected, or no current job there, and the tab does not exist. The tab label carries a count badge of how many duties there are.
The heading reads Assigned Duties, with the caption Duties assigned to this employee at {company}. While it loads you see Loading duties..., and where there are none you get No Duties Assigned with This employee does not have any duties assigned at this company. and an Assign Duties button.
The grid
| Column | What it shows |
|---|---|
| Duty | The name of the duty. |
| Status | Assigned, In Progress, Completed, On Hold or Cancelled. A duty with no status set reads Not Set. |
| Priority | Low, Normal, High or Urgent. Nothing set is treated as Normal. |
| Due Date | An overdue date is red and carries a warning icon. |
| Progress | How far along the duty is. |
| Requirements | A button reading {n} requirement or {n} requirements, or None. |
| Notes | An icon. Hover it to read the note. |
The grid can be filtered, and it is dense, striped and paged, so a long list stays readable. Beneath it a Duty Summary strip totals Total, Completed, In Progress and Overdue.
What a duty requires
Clicking the Requirements button opens Requirements for {duty}. The requirements are grouped by category, each with a green tick or a red cross showing whether the person meets it, and a Required chip on the ones that are not optional. This is the quickest way to see why somebody cannot be put on a particular duty.
A Manage Duties button appears at the top of the tab for anyone who can edit the profile, where there is a current employment. It leaves the profile for the duty assignment screen.
Like Qualifications, this list is fetched once and then kept for as long as the page is open. If you assign a duty in another browser tab, come back here and reload the page, or change the company picker, before you conclude it did not save.
Self-Identification and gender
Self-identification is the voluntary statement of Indigenous identity, visible-minority status, or neither. Tansi collects it for employment equity reporting. Giving it is always optional, and one of the six choices is Prefer not to say.
Self-identification, gender and emergency contact are treated as FOIP-protected information. They are hidden from employers until a candidate is hired. Inside Tansi they are visible to you on your own profile, and to an HR or management viewer only once a company is selected for an employee of that company.
The consent wording the person agrees to is shown in the dialog itself: Providing this information is voluntary. It may be shared with employers for employment equity purposes when you apply for jobs. Nobody should be pressed to complete it, and an administrator should not fill it in on somebody's behalf. If a person asks you to correct it, do it with them present.
A Developer in the central Tansi workspace can reveal these fields on another person's profile using a switch labeled Visible (dev only) under the heading FOIP-Protected Data. Every field revealed that way carries the banner FOIP-protected — visible to you as a developer. Hidden from employers until the candidate is hired. It exists for support work, and it is not a routine way to read somebody's record.
What the tab shows
The first card is headed Indigenous Community for someone who has identified as Indigenous, and Self-Identification otherwise. It is read-only; the pencil opens the Personal Information dialog at the self-identification section. Each row appears only when it has a value: a chip with the identification itself (Not specified when blank), First Nation: with the band name and province, Residency:, Reserve:, Other Nation:, Métis Province:, Settlement:, Inuit Community: and, for older records only, Band:. Where someone has identified as Indigenous but given no community detail, the card reads Community details not specified.
Filling it in
The picker offers six options: First Nation, Métis, Inuit, Visible Minority (non-Indigenous), Non-Indigenous, non-visible minority and Prefer not to say. What you choose decides what is asked next.
| If you choose | Tansi then asks for |
|---|---|
| First Nation | Your First Nation / Band, searched as you type. Then Residency Status: On Reserve (My Nation), On Reserve (Other Nation) or Off Reserve. |
| On reserve with your own Nation, a Reserve from that Nation's list. If the Nation has none recorded you are told No reserves found for {band}. | |
| On reserve with another Nation, the Other First Nation first, then its Reserve. | |
| Métis | Your Province of Affiliation. In Alberta you may also pick a Métis Settlement, which is optional and can be cleared back to No affiliation. |
| Inuit | Your Inuit Community. |
| The other three | Nothing further. |
A small inconsistency is worth knowing if you are reading older records. The stored data holds a few values the current picker does not offer, including a plural First Nations and the words Non-Indigenous and Not Disclosed. Tansi displays all of them correctly, so an older record may read slightly differently from a new one that means the same thing.
Proof of Indigenous Identity
Where someone has identified as Indigenous and has a candidate profile, an optional upload card appears, headed Proof of Indigenous Identity (Optional). It opens with a four-paragraph Proof of Indigenous Identity – Security & Use Notice covering why Tansi asks, how the document is encrypted, the promise that it is not shared with employers or sold, and the plain statement that verification does not guarantee employment.
- Pick an Identification Type: Status Card, Métis Citizenship, Inuit Beneficiary Enrollment or Other. Choosing Other adds a Describe Identification Type box.
- Upload an image of the document. You can crop, rotate and adjust it after uploading.
- Press Submit for Verification.
- The first time, set a Document Access PIN: Create a 4-6 digit PIN to protect your document. You'll need this PIN to view your uploaded proof of identity. Choose something you will remember.
Afterwards the card shows a status badge, Document Type:, Submitted: and three buttons: View Document (which asks for the PIN), Replace Document and Delete. PIN entry is rate-limited — you are told how many attempts remain, and then locked out for a while. Replacing a document warns first that Replacing this document will reset your approved verification status. You will need to wait for re-approval. If a document was rejected, the reviewer's words appear under Rejection Reason:.
The Gender card
Gender sits on this tab too, in its own card, and only where the workspace collects it. It shows Gender: and Disclosure: with a chip reading Allowed or Not Allowed, or No gender information provided. The pencil opens the Personal Information dialog at the gender section.
That section is explicit about what the answer is used for: Gender information is collected and used only for aggregated statistical purposes, including workforce reporting and diversity and inclusion measurement, and Gender information is not used to make hiring or employment decisions and is not publicly displayed. The field itself is optional, with Male, Female, Other and Prefer not to say, and a separate checkbox controls whether it may be shared with employers for equity reporting.
A workspace can turn gender collection off altogether. One caution for administrators: if Tansi cannot read that setting for any reason, it assumes the workspace does collect gender and shows the section. A workspace that has turned it off may therefore see it reappear after a transient error. Report it rather than filling it in.
The Roles tab
Roles appears for Administrators and Developers, and only while you are signed in to a real workspace. It is about this workspace alone: the same person may hold quite different roles somewhere else.
The heading is Roles in this workspace, with a Give them a role button. Where the person holds none you get a warning that says what that means in practice: They hold no role in this workspace. They can sign in and see nothing until somebody gives them one.
The table lists Role, What it is for, Since, Given by, Why and Actions. The one action is Take it away. Roles that come with Tansi are marked built in to Tansi.
How roles combine
Roles add up. Giving somebody a second role never disturbs the first. Where two roles say different things about the same module, the stronger one wins. So the way to reduce what somebody can do is to take a role away, not to add a smaller one.
The second part of the tab, What they can see and do, is the readout that matters. It lists the effective permission level for each module as a chip, with a line of plain English saying what that level means. Where nothing is open to them it reads Nothing — no module is open to them in this workspace. Check here after changing a role rather than reasoning it out from the role names.
While you are in the Roles and Account tabs it is quick to forget that the rest of the page belongs to the same person. The Actively Looking and Public Profile switches, the photo menu, the signature pad and Verify Now all act on your account, not theirs, even here.
Roles, account status and the Personal Information dialog are the parts of this page that reliably apply to the person whose name is in the banner.
The Roles tab has not been translated yet. A colleague working in French or Spanish will find the whole tab — the heading, Give them a role, Take it away, What they can see and do and the table headers — in English, while the rest of the page is in their language. Everything works the same; only the words are untranslated.
The Account tab
Account is the other administrator tab, with the same conditions as Roles: Admin or Developer, in a real workspace. It is about the sign-in account rather than the person — whether they can get into Tansi at all.
What the left column tells you
| Field | What it means |
|---|---|
| Status | A chip reading Invited, On hold, Active, Suspended or Decommissioned. |
| Tansi user ID | The internal identifier. An em-dash means none has been issued. |
| Created | When the account was made. |
| Last sign-in | The date and time, or Never signed in — which on an Invited account usually means the invitation was never taken up. |
| Decommission date | Or Not scheduled. |
The three buttons
Which buttons you see depends on the current status.
| Button | When it appears | What it does |
|---|---|---|
| Send invitation | Status is On hold | Moves the account to Invited and emails a link to set a password. The link is good for seven days and lands the person on the set-password page. Confirms with Invitation sent. |
| Suspend | Status is Active or Invited | Blocks the account, writes an audit record, sends a deactivation notice, and ends every sign-in that account currently has. |
| Reinstate | Status is Suspended | Puts the account back to work and sends a reactivation notice. |
Suspending is not only a change of status. Tansi now signs the account out everywhere: any browser that person has Tansi open in will stop working within roughly half a minute, wherever they are. Until late 2026 a suspended person could keep working for up to an hour, so if you remember it behaving gently, it does not any more.
That is the right behavior for a departure or a security concern. It is the wrong behavior for a mistaken click on a colleague who is mid-task. Check the name in the banner before you press it.
If the status moves to Invited but the email does not go, Tansi says so with a warning reading Invitation email failed. The status change still stands — only the message failed.
The account is now sitting at Invited with nobody told about it, and Send invitation will no longer be offered, because that button appears only for accounts on hold. Contact the person another way, or ask for the invitation to be reissued.
Status history
The right-hand column is a vertical timeline of every transition: what it changed from and to, when, where the change came from and the reason given. A new account reads No history yet. This is the record to check before you ask anybody what happened.
One oddity: the from and to words in the timeline are shown in their raw internal form and are never translated, so they stay in English in a French or Spanish session. The chip at the top of the page is translated normally.
Unlike Qualifications and Duties, the Account tab re-reads the user record every time you click it. If you are watching a status change made by somebody else, clicking away and back is enough; you do not need to reload the page.
Settings
Settings is the last tab, and it is always there. It holds four cards, three of which appear on your own profile only.
Profile Visibility
| Switch | What it does |
|---|---|
| Public Profile | Allow recruiters to find your profile in searches. Off means you do not appear in recruiter searches at all. |
| Actively Looking | Show recruiters you're open to opportunities. This is the same setting as the Looking for Work card on Overview. |
These two switches are enabled for Administrators and Developers on any profile, but they write to the signed-in account rather than to the person on screen. The switch moves and the message says it worked, so there is nothing to warn you.
Changes that must land on another person go through the pencil and the Personal Information dialog. Visibility is not in that dialog, so ask the person to set it on their own profile.
Job Alerts
On your own profile only. Job Alert Emails turns the emails on and off: Get an email when a new job matching your occupations is posted. We match by NOC group.
Beneath it, My occupations (NOC codes) is the list Tansi matches against. Its help text explains how the list behaves: NOC codes from your resume show up here automatically. Add more or remove any you don't want — removing one here won't change your resume. A job posted as 72200 also notifies you if your interest is 72400. Occupations that came from your resume carry a From your resume chip.
To add one, type in Add an occupation — the box searches by code or by occupation name — and press Add. With none at all the card reads No occupations yet. Add the NOC codes you want to be alerted about., and no alerts will reach you.
Public store
Also your own profile only. This publishes a single page listing the courses and webinars you have published publicly: Share a public page with all your published, public courses and webinars. Private (workspace) items are never shown.
- Turn on Enable my public store.
- Pick a Store handle — the short name in the web address. Lowercase letters, numbers and hyphens, 3 to 30 characters.
- Write a Tagline (optional) if you want one line about yourself above the list.
- Press Save, then Copy link to share it or Open store to see what visitors see.
Leave the switch off and the card tells you what people will find: Your store is currently disabled — the link will show "Store not found" until you enable it. Any link you shared earlier stops working until you turn it back on.
Security
The last card has one control: Change Password, with the reminder Changing it needs your current password. That is the only security setting on this page.
Two-factor authentication, your remembered devices and the sign-in email section all live on the Security Settings page at /account/security. Get there from the avatar menu, then Settings.
That page is where you set up an authenticator app, SMS or email codes, see which devices you have asked Tansi to remember, and sign them all out at once. If your organization requires two-factor authentication, that page says so with a badge.
Changing your sign-in email
Your email address is also your sign-in, which is why changing it is kept out of the Personal Information dialog and given a Change button of its own, on the Contact Information card on the Overview tab. The tooltip reads Change your sign-in email. The button appears on your own profile only — nobody can change somebody else's sign-in from here.
The moment the code is accepted, Tansi confirms with Your sign-in email is now {address}. Please sign in again. and signs you out immediately. There is no final are-you-sure, and no chance to go back and save something.
Anything half-finished in another Tansi tab is lost. Save your work, then change the address. Changing your password, by contrast, keeps you signed in.
The two steps
- On Overview, find Email: on the Contact Information card and press Change. The dialog reminds you You sign in with {current address}.
- Type the New email address and your Current password. Send code stays unavailable until both are filled in.
- Check the new address for a six-character code. The dialog now reads Enter the code we sent to {new address} and the code expires in ten minutes.
- Type the code into Verification code. The confirm button becomes available at exactly six characters.
- Sign in again with the new address and the same password.
If the code does not arrive, Resend code is available after a 60-second wait, counting down on the button as Resend in {n}s. If you mistyped the address, Use a different address takes you back to the first step without closing the dialog.
That is the point of the second step: it proves you can actually receive mail at the address you are about to sign in with. If you cannot open the new mailbox yet, do not start.
Changing your password
Change Password is on the Security card of the Settings tab, on your own profile. You need your current password to do it.
The dialog has three fields — Current password, New password and Confirm password — each with an eye icon that shows what you typed. A checklist under the new password ticks green as you meet each rule.
| Rule | What counts |
|---|---|
| At least 12 characters | Length is the rule that does most of the work. A short phrase of a few unrelated words is easier to remember than a mangled word and harder to guess. |
| An uppercase letter | A to Z. |
| A lowercase letter | a to z. |
| A number | 0 to 9. |
| A special character | One of @ $ ! % * ? &. |
The submit button stays unavailable until the current password is filled in, all five rules are ticked, and the two new entries match — a mismatch says Passwords do not match. Tansi checks your current password before it changes anything, so a wrong one comes back as Current password is incorrect with nothing altered.
On success you get Your password has been changed. and you stay signed in. Unlike changing your email, this does not interrupt what you were doing.
Somebody setting their password for the first time from an invitation email meets the same five rules on the set-password page. If their link has gone stale they see That link is no longer valid. Ask your administrator to send a new invitation. — invitation links last seven days.
Working in French or Spanish
Tansi runs in three languages. You pick one for yourself, and it follows you.
| In the switcher | Language |
|---|---|
| English | English, and the language Tansi falls back to when a phrase has not been translated yet. |
| Español | Spanish. |
| Français | French. |
Where the switcher is
There is no language control on the profile page itself. Signed in, it is in the profile menu: click your avatar at the top right, and the Language row sits between Dark mode and Switch workspace, showing your current language in its own name. Open it and the three languages are listed, each written in itself, with a tick beside the active one.
Before you sign in there is a second switcher in the top bar — a globe icon with a two-letter code, EN, ES or FR, beside the cart, dark-mode and help icons. It does the same thing for visitors.
Changing language is a real page reload, not an in-place swap. Tansi has to reload because the page was built in the old language from the moment you opened it.
Anything typed into an open form and not yet saved is lost. Close your dialogs and save your work before you switch.
How your choice is remembered
Two things happen when you switch while signed in. Tansi stores the choice on this browser, and it also saves it to your account. So your language follows you to a new computer or a new browser, where the account setting is read on the first visit. After that the browser's own copy takes over, which is why changing it on one computer does not immediately change what you see on another one you are already using.
If you switch language before signing in, the choice lives only on that browser. It is attached to your account the first time you switch while signed in. A ?lang= in a link from an email also sets the language for that visit, but it never overrides a choice you have just made in the switcher.
Two places that stay in English
- The Roles tab. It has not been translated at all, so the heading, Give them a role, Take it away, What they can see and do and the table headers stay in English however you are working.
- The from and to words in the Status history timeline on the Account tab. These are shown in their raw internal form on purpose and are never translated. The status chip at the top of the same tab is translated normally.
Both are administrator screens, so most people will not meet them. Everything else on the profile — the tab strip, the cards, the dialogs and the confirmation messages — is translated, and dates and times follow the language you chose.
The French and Spanish wording of the FOIP, gender and self-identification text is marked in Tansi as awaiting human review. Treat those translations as provisional. Where the precise wording of a consent statement matters, read the English version alongside it, and tell your administrator if a phrase reads wrongly.
Every page in this module
The profile is one page with ten tabs, but it links out to a number of others. This is the whole set.
| Address | Name | What it is for |
|---|---|---|
| /my-profile | My Profile | Your own profile. Opens on the Dashboard tab. |
| /my-profile/{user id} | Profile | Somebody else's profile, as far as your access allows. Opens on Overview and carries a banner saying whose it is. |
| /my-profile?tab={name} | A particular tab | Opens the profile with that tab selected. A name Tansi does not recognize leaves the body blank until you click a tab. |
| /my-profile?jobId={id} | Job Match view | Adds the Job Match card scoring this person against that job, with Invite to Apply where it applies. |
| /my-profile?requirementTemplateId={id} | Add from template | Opens the Add Qualification dialog already filled in from that template. |
| /candidate/personal-information | Candidate profile | Where the Complete Profile button goes. Creates the candidate record the Resume Builder and Qualifications need. |
| /resume-builder | Resume Builder | The full resume editor, the same one embedded in the profile tab. |
| /admin/employees/new/{candidate id} | New employee | Where Add Employee goes. HR, Admin and Developer only. |
| /admin/employees/assign-duties/{employee id} | Assign duties | Where Manage Duties and Assign Duties go. |
| /account/security | Security Settings | Two-factor authentication, remembered devices, sign-in email and password. Reached from the profile menu's Settings item. |
| /account/notification-settings | Notification Settings | Which events Tansi notifies you about, event by event. |
| /my-notifications | My Notifications | The full notification list. The Dashboard widget is a short version of it. |
| /account/set-password | Set password | Where an invitation email lands. Links last seven days; the same five password rules apply. |
Dashboard, Overview, Qualifications, Resume Builder, Employment, Duties, Self-Identification, Roles, Account and Settings are all one page. Moving between them does not reload anything, which is why a change made in another browser tab may not appear until you reload.
CRM
Who you sell to and how the work comes in — accounts, contacts, leads, opportunities and the paperwork that turns one into the next.
Before you start
The CRM is where Tansi keeps the people and companies you sell to, the work you are chasing, and the paperwork that turns a conversation into a signed contract. It sits in the Sales & Clients area of the main navigation, under the subtitle Leads, pipeline & campaigns.
Most of this module is for two kinds of reader. A salesperson lives in Leads, Opportunities, the Pipeline board and My Activities. An office administrator lives in Accounts, Contacts, Events, the quote and invoice flows, and the settings that keep everyone else's dropdowns sensible. A handful of sections are marked for administrators only — CRM Settings and the Chart of Accounts.
What access you need
Every CRM page is gated twice. You need the module entitlement module:crm, and you need the feature permission for the page itself. Without the module, nothing in Sales & Clients appears at all — not a greyed-out link, nothing.
| Permission | What it unlocks |
|---|---|
| CRM | The whole module. Without it the Sales & Clients area is absent. |
| Accounts | The Accounts list and account records. It also sets the ownership scope for the entire CRM — see the warning below. |
| Contacts | The Contacts list, contact records, and vCard import and export. |
| Leads | The Leads list and lead records, and Lead Forms — both the list and the per-form editor. |
| Opportunities | The Opportunities list, opportunity records, the Pipeline board and Reports. |
| Activities | My Activities. |
| Events | The Events list, event records, check-in, and Spaces & calendar. |
| Procurement portals | The Procurement Portals list and its dialogs. |
| CRM admin | CRM Settings, every panel, plus the Chart of Accounts and Campaigns. |
Your permission level on Accounts sets the ownership scope for every other CRM page. If you are given a view-own or edit-own level on Accounts, you will see only the records you own in leads, pipeline, reports and everywhere else — even when your level on Leads is higher. This is deliberate, and it is the single most common cause of someone asking why half the list is missing.
Events use three permissions, not one. Events opens the list, the record, check-in and Spaces & calendar. A separate Events matchmaking permission shows the Networking tab and the Networking type… action on attendees, and an Events sponsors permission shows the Sponsors tab. Each needs the edit level for changes. Check-in needs edit on Events, not only view. Publishing recordings as a course also needs edit on course management in the event's workspace.
Levels, and what happens when a check fails
Permission levels run from none, through view-own and view, to edit-own and edit. In general you need any level above none to see a page, and edit to change anything on it.
Permission checks fail closed. If a lookup goes wrong — a dropped connection, a slow workspace switch — the feature disappears rather than opening up. Developers are the exception. If a button you use every day is suddenly not there, reload before you raise a ticket.
Working across workspaces
If your account can view all workspaces, a Tenant picker appears at the top of every CRM list. Until you pick a workspace, the New … button on each list stays disabled, with a hint such as Pick a tenant above to add a lead. This is not a fault — a new record has to belong somewhere.
What is not in this module
CRM Campaigns at /crm/campaigns moved into Mass Communication and has its own module — see Module 04. The navigation entry still sits under Sales & Clients, so you will find the link here and the instructions there.
Two permissions people overlook
- Projects have no permission of their own. They follow Opportunities: edit or edit-own on Opportunities lets you edit a project, and view-only lets you look.
- CRM admin is all or nothing inside CRM Settings. Anyone who can open the page can change every panel in it.
Glossary
CRM vocabulary is the thing newcomers get wrong, and getting it wrong costs real time — a company typed in as a person is awkward to untangle later. Read this once before you create anything.
| Term | What it means |
|---|---|
| Account | A company you do business with. Accounts hold contacts, opportunities, projects, billing details and a team. The Accounts list subtitle says it plainly: Companies you do business with. |
| Contact | A person. A contact usually belongs to an account, has one or more emails and phone numbers, and carries their own consent settings. The Contacts list subtitle is Reach the right people, the right way. |
| Primary contact | The one person on an account Tansi reaches for first. It shows as a chip on both the account and the contact. |
| Lead | Somebody who is not a customer yet. A lead is a single record holding a name, a company and a way to reach them. Leads live apart from contacts until they are converted. |
| Convert (a lead) | Turning a lead into a contact, and usually an account, and optionally an opportunity. A converted lead leaves the Leads area. |
| Opportunity | A deal you are working — a bid, a tender, a quote in progress. It has a value, a stage, a probability and a submission deadline. |
| Stage | A column on the Pipeline board. Each stage has a type — open, won or lost — and a probability that drives the weighted forecast. |
| Probability | The percentage chance of winning, set automatically from the stage and overridable per deal. |
| Weighted value | Each deal's value multiplied by its stage probability. It is the number to forecast from. |
| Submission deadline | When the bid is due. It is the default sort on the Opportunities list and it drives the countdown on the opportunity record. |
| Project | What a won opportunity becomes. A project mirrors the opportunity layout and is reached from the won opportunity or the account's Projects tab. |
| Activity | Anything logged against a record — an email, a text, a call, a meeting, a task, a note, tracked time. Activities make the timeline. |
| Task | An activity with a due date and an owner. Open tasks drive My Activities and the Next action card on a lead. |
| Lead form | A public web form strangers fill out to become leads. You can have several, each with its own questions, owner and notifications. One is the default. |
| Default form | The lead form that booking pages and calendar invites use. It cannot be deleted until another form is made the default. |
| Pipeline | All your open opportunities, seen as a board of stage columns. |
| Going cold | An open lead with no activity for a set number of days. The number is a workspace setting, not a fixed value. |
| Archived | A record taken out of every list but kept with its history. Archived records are read-only until restored. |
| Saved view | A named filter across the top of a list, such as Unassigned or Going cold. Views are deep-linkable. |
| Picklist | The set of choices behind a dropdown — lead status, lead source, account type, activity type, contact type, loss reason. |
| Custom field | An extra field added to one record type. Its key is what exports and integrations use. |
| Table view | A spreadsheet-style surface on a list or a record, built on Tansi Sheets. It is a permission, not a preference. |
| Chart of accounts | The account codes that quote, invoice and cost lines are coded against. They belong to one workspace. |
| Workspace | One tenant's CRM. Settings, stages and account codes belong to a single workspace unless you are editing global defaults. |
| Procurement portal | A tender site you bid on. Tansi stores where it is, who buys there, the keywords you search by, and optionally a sign-in. |
| Vendor price request | A private page sent to a supplier asking them to price the items on a bid. |
| Pass | A ticket type for an event — a price, a quantity, a sales window and a visibility setting. |
| Attendee type | A networking category for event attendees. It decides who may request meetings with whom, and the band color on a badge. |
| Client portal | A read-only page you share with a client, showing selected quotes, invoices, documents, notes and tasks for one record. |
How the module is laid out
The CRM navigation is grouped by what you are doing, not by what the data is called. Learn the five chip groups and you can find anything.
| Group | What is in it |
|---|---|
| Clients | CRM Home, Accounts, Contacts — who you sell to. |
| Pipeline | Leads, Lead Forms, Opportunities, Pipeline, My Activities, and an alias through to My Booking Pages in the Calendar module. |
| Campaigns | Campaigns. Covered in Module 04. |
| Events | Events, and the Spaces & calendar page behind it. |
| Procurement | Procurement Portals. |
| Insights | Reports. |
| Settings | Chart of Accounts and CRM Settings. Administrators only. |
Patterns you will see on every screen
- Saved views — a tab strip of named filters across the top of a list, each deep-linkable, so you can bookmark or share one.
- A toolbar with a live count, a search box, one or two dropdown filters, an export menu and a view switcher.
- A view switcher — lists offer some combination of Kanban, Tile, Grid, List and Table. Table only appears when your permission level allows it.
- A bulk bar that slides in when you tick rows, offering the actions that make sense for the selection.
- Tabs on records, each with a count badge, each addressable from the address bar.
- A Keyboard button opening the shortcuts for that page.
The Keyboard button
Every redesigned CRM surface carries a Keyboard button that opens a shortcut dialog for that page. You will find it on the leads list and lead record, the lead form builder, the overview, accounts and the account record, contacts and the contact record, the opportunity dialog, the pipeline, reports, settings and the chart of accounts. The shortcuts differ per page, which is why the dialog does too.
Record tab strips are a single stop on the Tab key — once you are in the strip, the arrow keys move between tabs, and Home and End jump to the first and last. The open tab is part of the address: accounts and contacts use ?tab=, opportunities and projects use a # hash.
State is never color alone
Deadline urgency, row states and chart series all carry a word or a pattern as well as a color. An overdue submission deadline is red and bold. A due chip says Overdue, Today or On track in words. Every chart on the Reports page and the CRM Home page has a table view behind a switch.
When something is missing
Two quiet rules explain most vanished buttons. Permission lookups fail closed, so a transient error hides the feature rather than exposing it — this applies to the Networking and Sponsors tabs on events and to edit buttons generally. And a navigation entry with an unrecognized permission key resolves to false, which hides the link.
In view-all mode, custom fields list only the definitions belonging to the record's own workspace. You will not see another workspace's custom fields on a record that is not theirs.
CRM Home
CRM Overview at /crm is a snapshot of your pipeline and your open tasks. It is not a report — it is a to-do list with numbers on top. Its subtitle says A snapshot of your pipeline and open tasks.
The header carries three buttons: Pipeline, Reports and New lead. In view-all mode with no workspace picked, New lead is disabled and the hint reads Pick a tenant above to add a lead.
The comparison period
The control labeled Compare with sets what the deltas are measured against: Last 7 days, Last 30 days, Last 90 days or Month to date. Changing it is announced aloud for screen reader users — Figures now compared with: … — and it changes every arrow on the page at once. A tile that looks flat against seven days may be well up against ninety.
Key figures
Four tiles, each with a twelve-week sparkline and a change against the comparison period: Pipeline value, Open leads, Open opportunities and My open tasks.
When your pipeline holds deals in more than one currency, the tile shows the headline figure in the currency with the largest open total and a Plus line underneath listing the total in each other currency with its code. Those deals are real. They are not in the number.
The charts
- Open opportunity value by stage — a horizontal bar chart with a View as table and Hide table toggle. The table has Stage, Value, Deals and Share columns, plus a total row. When there are no open opportunities the empty state offers a Go to opportunities button, and when every deal sits in one stage the page explains why no chart is drawn rather than drawing a single meaningless bar.
- Leads created — a weekly line over the last eight weeks, with its own table of Week of and Leads. When nothing has come in, the empty state reads No new leads lately and offers Set up the lead form.
Needs attention
The most useful block on the page. Each row is a problem with a button on it:
| Row | What it means and what the button does |
|---|---|
| Unassigned leads | Leads nobody owns. Assign opens the leads list filtered to them. |
| No activity in {n}+ days | Open leads with no activity or edit for the workspace's going-cold threshold. Review opens the Going cold view of the Leads list. |
| Opportunities due this week | Deals whose submission deadline lands in the next seven days, or whose expected award date does when there is no deadline. With exactly one, Open goes straight to that deal; with more, Review opens the Pipeline board. |
My open tasks and Jump to
A short list of your open tasks, each with a due chip reading Overdue, Today or On track, with View all and Open My Activities beneath, and a +{n} more in My Activities line when the list is truncated.
The Jump to strip at the bottom links to Contacts, Accounts, Opportunities (with the open count beside it), Campaigns and Procurement portals.
What the figures are built from
- Each key-figure tile is a link: Pipeline value opens the Pipeline board, Open leads the Leads list, Open opportunities the Opportunities list, and My open tasks My Activities.
- For My open tasks, a fall is shown as good news; for the other tiles, a rise is.
- Past figures are rebuilt from when each record was opened and closed. Past pipeline value uses each deal's current amount, so editing an amount today changes the history line too. Archived records drop out of the history entirely.
- The stage chart leaves out stages with no open deals.
- My open tasks shows the first five only — overdue first, then by due date, undated last — with a +{n} more in My Activities line for the rest.
- In view-all mode the going-cold row uses the default of 7 days rather than a workspace's own setting.
Accounts
An account is a company. Everything else in the CRM hangs off one — contacts work there, opportunities are bid for them, projects are delivered to them, invoices are sent to them. Getting the account right once saves a lot of tidying later.
The Accounts list
/crm/accounts opens with the saved views across the top: All accounts, Customers, Prospects, My accounts and Incomplete. Below them sit Search accounts — which matches name, website, industry or phone — and filters for Type, Industry and Owner (Anyone, Me, Unassigned), with Clear filters beside them.
The Columns picker shows how many columns are on, marks each as shown or hidden, and offers Reset to default. The Account column is always shown.
The completeness banner
A banner counts the accounts missing an industry or a phone number and explains why it matters: Empty fields can't be sorted or filtered. A Show incomplete accounts button and a percentage meter sit beside it. Inside the table, empty cells carry their own fix-it buttons — Add industry, Add phone, Assign — so you can repair a row without leaving the list.
Columns and row actions
| Column | What it shows |
|---|---|
| Account | The company name with its website underneath, or No website. |
| Type | Customer, prospect, and whatever else your workspace has added to the account type picklist. |
| Industry | Free text typed on the account, blank where nobody has filled it in. The Industry filter lists the values already in use. |
| Phone | The main number. |
| Owner | Who the account belongs to. |
| Open pipeline | {n} open deals or No open deals. |
| Contacts | How many people are on file. |
| Last activity | Today, Yesterday, a day count, a week count, or No activity. |
Every column header is a button that sorts, and the sort is announced — Sorted by Owner, ascending. Each row offers Email and Call shortcuts and a More actions menu with Open account, Edit account…, New opportunity…, Assign owner… and Change type…
Tick rows and the bulk bar appears, offering Assign owner, Change type, Export selected and Clear selection. The export adds Website, Email, Open deals and the active view to whatever columns you have visible.
Creating and editing an account
New account and Edit account open the same wide dialog. Name is the only required field. The rest is Type, Industry, Phone, Email, Preferred contact method, Website and an address block.
The helper on Preferred contact method says it plainly: it is used for this account's contacts unless they set their own. Set it on the account for the general case, and let individuals override it on their own record.
A This is also the billing address checkbox sits under the address. Untick it and a separate billing address appears. A missing billing address blocks sending a quote later, so it is worth filling in before you need it.
The account record
The record opens with an identity card: the name, Account #{n}, an owner chip or No owner, a link chip to the primary contact, and a live activity chip reading anything from Last activity just now to No activity yet. The breadcrumb reads Clients › Accounts, followed by the account name.
Header actions are Email, Call, Edit and New opportunity, with Send SMS in the More actions menu. Where the detail is missing, the button says so rather than failing: Add an email address, Add a phone number, Send SMS — no phone on file.
A Key notes strip runs above four key-figure tiles — Open pipeline, Won value, Active projects and Contacts — and each tile jumps to the tab behind it.
The tabs
| Tab | What it holds |
|---|---|
| Contacts | The people at this company, as cards, with channel hints. |
| Opportunities | Name, Amount, Stage, Status, Close date and Owner. |
| Projects | Project number, Name, Contract value, percent complete and Target date. The empty state explains where projects come from: converting a won opportunity. |
| Team | The people assigned to this account, with their rates. |
| Billing | Billing detail; it can prompt you to set a missing rate. |
| Timeline | The full activity feed, with the composer. |
| Messages | The SMS conversation. The tab is hidden when the account has no phone number. |
| Chat | Record chat, through Tansi Chat. |
| Notes · Custom fields · Related · Forms | The shared surfaces described later in this module. |
Open pipeline and Won value show one line per currency, so nothing is mixed there. The contracted figure on the Active projects tile totals project contract values without converting currencies, because projects do not carry one. On a single-currency account this is exactly right. On a mixed one, treat the figure as indicative and check the projects themselves.
The Team and Billing tabs are explained in Account team, rates and billing. Change type… opens a dialog with a single Type list; if the workspace has none it says No account types are available.
Smaller things worth knowing
- Customers and Prospects filter on the account type. Incomplete means missing an industry or a phone number.
- Rows per page offers 25, 50 or 100, with Previous page and Next page buttons beside the range.
- The Last activity cell is flagged once an account has gone 14 days without activity.
- Sorting puts empty values last in both directions, so accounts with no industry never crowd the top of the list.
- The Email and Call row shortcuts only appear when the account has an email address or a phone number.
- There is no delete for accounts on the list or the record.
- Unticking This is also the billing address reveals Billing address, which Prints as “Billed to” on quotes, invoices, proposals and contracts.
- Account custom fields appear at the bottom of the account dialog.
Contacts, consent and reaching people
Contacts are people. The list's subtitle is the whole philosophy of the page: Reach the right people, the right way.
The Contacts list
The header carries Keyboard, an Archived and Active contacts toggle, Import vCard (a .vcf file picker) and New contact. The toolbar has a live count, a search across name, company and email, an export menu, a Group by account chip on the global list, and a view switcher offering Tile, Grid, List and Table.
The filter chips are where the real work happens: All, Primary, Emailable, Opted out, Subscribers only and Hide subscribers, plus Type and Tag selects.
People who only ever subscribed to a mailing list stay out of CRM audiences until somebody works them. That is what Subscribers only and Hide subscribers are for — one chip to find them, one to get them out of the way.
Best channel hints
Each card can show Best channel: {x} followed by either — their stated preference or — suggested from what's on file. The difference matters. The first is something the person told you. The second is Tansi's guess from the data. A Best star marks the channel, and an unavailable channel says why it is unavailable.
Creating a contact
The contact dialog is a wide five-section form with a rail down the left — Contact information, Work, Address, Other and Notes. Below the small breakpoint the rail becomes a Section dropdown.
- Contact information — First name is the only required field, and the rail marks the section that holds it. Then last name, preferred name, contact type (with the helper Leave blank if you're not sure yet), email with a type selector and Add email, phone with a type, a Can text checkbox and Add phone, Add fax, and preferred contact method.
- Work — organization, job title, department, account, and a Primary contact checkbox.
- Address — country-aware, so the province and postal code rules follow the country.
- Other — website, how we met, owner, socials (LinkedIn, Facebook, X, Other — handle or URL), tags, tenant (read-only: Tenant follows its account — change it on the account), custom fields — the photo is at the top of Contact information, not here.
- Notes — free text.
vCard prefill works on create only. Opening an existing contact and importing a .vcf will not take the imported values over the stored ones, so an import cannot quietly rewrite somebody's details.
The contact record
The breadcrumb reads Clients › Contacts, then the name, with the job title and company underneath and Contact #{n}. Header actions are Export vCard, Edit, Contact (which opens the reach sheet) and More actions with send email, send SMS and delete — each naming the reason when it cannot run, such as No mobile number on file.
The chips under the name tell you the state of the relationship at a glance: a Primary contact chip where it applies, a consent line reading Opted in to email & SMS, Email only — opted out of SMS, SMS only — opted out of email or No marketing — opted out of email & SMS, and a recency chip from Not contacted yet through to a day count.
A quick group headed Log an activity for {name} offers Task, Track time and Notify. The tabs are Timeline, SMS, Notes, Custom fields, Preferences, Forms and Campaigns. The Timeline is read-only history — a read-only record of everything that happened — and its filter chips announce how many entries each filter left.
Communication preferences
The Preferences tab holds two switches and one selector. Email campaigns covers newsletters and campaign sends; Text messages covers SMS. Best channel offers Automatic, Email, Call or Text.
Turning off Email campaigns does not cut the person off. The helper says so: Newsletters and campaign sends. One-to-one email from this record still works.
Every change to a channel switch is recorded with the date it happened and where it came from: changed by your team, via the unsubscribe link, carried over when the lead was converted, via a public form, or imported. The tab says why: Turning a channel off is recorded with the date, so you can show when consent changed.
This is what you produce when someone asks you to prove you had permission to email them. Do not work around it by editing a contact to re-enable a channel somebody turned off — that is recorded too, as a change by your team, and it is the wrong answer to the question.
Texting: two switches have to be on
Two separate things decide whether you can text somebody. The workspace needs an SMS number — without one the buttons are disabled with Texting needs a workspace phone number — contact your administrator. And the individual number needs Can text ticked. A landline on file does not enable SMS, however much you would like it to.
Archiving versus deleting
When you delete a lead or a contact, Tansi looks at what points at it. A record with any history — calls, emails, texts, notes, documents, bookings or booking-link shares — is archived. Only a record nothing points at is deleted permanently. Bookings and booking-link shares count as history, which surprises people.
Archived records keep their history and stay out of every list until restored, and they are read-only while archived. The Delete item is hidden on rows that are already archived.
The archived banner is worth reading: Archived contacts keep their history and stay out of every list. Open one to restore it. This also includes contacts deleted before archiving existed. So the archive is also where old deletions went.
The dialog shows which case applies. With history: {name} has history on file: and the counts (calls, call recordings, emails, texts, campaign sends, notes and so on), then It will be archived — hidden from your lists, with everything above kept. You can bring it back from the Archived filter. and an Archive button. Without: {name} has no history: no calls, emails, texts, notes or documents. and Delete permanently. If history arrives while the dialog is open, Tansi archives instead and tells you: New history arrived just now, so {name} was archived instead of deleted.
On contact and lead cards, a Socials pill shows the profiles on file; its menu opens each one in a new tab.
The Organization box can create an account
In the contact dialog's Work section, Organization suggests your existing accounts as you type. Its helper text tells you what will happen when you save: Will link to the existing account., or Will create the account “{name}” when you save.
If the name you type does not match an account, saving the contact creates a new account with that name, as a Prospect, and links the contact to it. Pick the suggestion from the list, or choose the company in the Account field, to avoid near-duplicate accounts.
Importing a vCard, in detail
- Import vCard only fills in the New contact form. Nothing is saved until you review it and select Save.
- A file that holds several cards loads the first one only: That file holds {n} contacts; the first one was loaded. Import the rest one card at a time.
- A contact holds two addresses. Extra addresses on the card are dropped, and Tansi says how many.
- Files over 10 MB are refused as too large to be a contact card.
Photo, addresses and tags
The photo sits at the top of Contact information, with Add photo, Replace photo and Remove. The Address section takes an Address type — Mailing, Physical, Billing, Home, Work or Other — and Add address opens a second one. Once you type any part of an address, the country is set to Canada unless you change it. Tags are picked in the Other section.
Who a text reaches
The Text messages switch on Preferences covers campaign texts and one-to-one texts from Tansi — Campaign texts and one-to-one texts from Tansi. — unlike the email switch, which leaves one-to-one email working.
The Contact reach sheet will not offer a text to someone who opted out of SMS. The Send SMS item in the record's More actions menu, however, only checks for a textable number and a workspace SMS number. Look at the consent chip under the name before you use it.
Archived leads and contacts, and bringing them back
Leads and contacts are rarely deleted outright. When you delete one, Tansi checks whether anything points at it — calls, emails, texts, notes, documents, bookings or booking-link shares. If anything does, the record is archived: it keeps its history and disappears from every list. Only a record with nothing attached is removed for good. The confirmation toast tells you which happened: Contact archived. or Contact deleted.
Opening the archive
Both lists have the same button in their header. On Contacts select Archived; on Leads select Archived. The button then reads Active contacts or Active leads, which takes you back.
While you are looking at the archive, New contact, New lead and Import vCard are unavailable, and a banner explains what you are seeing: Archived leads keep their history and stay out of every list. Open one to restore it. This also includes leads deleted before archiving existed.
Restoring a record
- Open the archive and select the person.
- Read the banner on their page — This contact is archived (since {date}). Its history is kept and it stays out of every list until you restore it.
- Select Restore in the header.
Tansi confirms with Contact restored. and the person returns to every list, with their timeline, notes and documents intact.
The Restore button, like Delete, needs edit or edit-own access to Contacts (for contacts) or Leads (for leads). If someone's access changes while the page is open, the restore is refused with You no longer have access to restore this contact.
Records deleted before archiving existed were moved into the archive. If someone insists a contact used to exist, look in Archived before you recreate it — restoring keeps the history a new record would not have.
Leads
The Leads list at /crm/leads is where new interest lands before it becomes a customer. Its subtitle is Track and qualify new leads.
Saved views
Each view carries its own count, and each is deep-linkable — /crm/leads?view=unassigned goes straight there, which makes a view quick to bookmark or paste into a message.
| View | What it holds |
|---|---|
| All | Every active lead. |
| My leads | Leads you own. |
| Unassigned | Leads with no owner. The first place to look each morning. |
| New this week | Recently created leads. |
| Going cold | Open leads with no activity for the workspace's threshold. |
| Converted | Leads that became contacts. They appear in no other view. |
| Emailable | Leads you may email. |
| Opted out | Leads who have opted out. |
Selecting Going cold shows a hint naming the actual number of days and linking to CRM Settings, because the threshold is a workspace setting rather than a fixed value.
The toolbar
A live count, a search across name, company and email, a Source select, an Organization autocomplete, an export menu, and a view switcher offering Kanban, Tile, Grid, List and Table.
The Organization box only filters when you pick a suggestion from the list. Typing three letters and stopping will not empty the page on you. If the list does not narrow, you have not picked a suggestion yet.
Filters, search text, view mode and grouping stay put across a reload. The lists deliberately keep their state so that creating a lead or switching workspace does not throw away what you were looking at. The other side of that choice: if you expected a clean slate, you will have to clear the filters yourself.
Working in bulk
Tick rows and the bulk bar offers Assign owner, Change status (listing the statuses that are not hidden), Delete where you have permission, and Clear selection. Deleting follows the same archive-or-delete rule as contacts.
Assign owner opens a single Owner list of the workspace's active users. Clearing the list and selecting Assign removes the owner, which sends the leads back to Unassigned.
The list columns
Name, Company, Status, Source, Owner and Last activity, with a checkbox and row actions. Source is not sortable. The table caption tells screen reader users how to sort: Leads matching the current filters. Use the column header buttons to sort.
When nothing is there you get No leads yet — New leads you create or capture will appear here, and when a filter is too tight, Nothing matches — No leads match the current search or filter. Try clearing them.
Exactly what each view counts
| View | The rule |
|---|---|
| New this week | Created in the last seven days. |
| Going cold | Not converted, and the later of its last edit and its newest activity is older than the threshold. |
| Emailable | Has an email address and has not opted out of email. |
| Opted out | Opted out of email, of SMS, or both. |
A lead captured with no name shows its company, then its email, then Lead #{n} in the list, so no row is ever blank.
The header also has an Archived button, which switches the list to archived leads — see the section on archived leads and contacts.
The lead record, and converting a lead
A lead record is built to answer one question quickly: where is this, and what happens next. The breadcrumb reads CRM › Leads, with Lead #{n} · Created {date} underneath.
The pills
A row of pills across the top gives you the state without scrolling: Status, Converted {date} where it applies, a contact-recency pill running from Not contacted yet to No contact for {n} days, Source and Owner.
The recency pill counts emails, texts, calls and meetings. Notes and tasks do not count toward it. But a note, a task or an edit does keep the lead out of the Going cold view. So a lead can read No contact for 40 days and still not be going cold — both numbers are right, they are measuring different things.
Lead progress
A path runs New → Working → Qualified → Converted. Conversion beats status: once a lead is converted, that is where it sits regardless of its status field. Where a status is not on the path, Tansi says so rather than guessing — Off the path: marked Unqualified, or Custom status “{x}” isn't a step on this path.
Next action
The card shows the earliest open task, with undated tasks last. It states whether the task was due, is due today, is due {date}, or has no due date, and offers Mark done and Open task. When there is nothing scheduled the empty state is a nudge: No next action — Schedule a follow-up so this lead doesn't go cold, with an Add a task button.
The panels and tabs
- Contact — email, phone, fax, other, website, address, company, job title.
- Lead details — owner, status, source, created date, what it converted to, preferred contact method, and the consent line.
- About — free text.
- Linked people — other leads and contacts connected to this one. The note on the panel matters: New notes here are shared with these people automatically.
The tabs are Timeline, Time, Messages, Notes, Custom fields, Preferences, Forms and Campaigns.
Creating and editing a lead
The lead dialog uses the same five-section shell as the contact dialog — Lead information, Work, Address, Other, Notes. First Name is the only required field. Email and phone each take a type, phones take a Can text tick, and both allow additional entries. Source and Status come from picklists an administrator maintains.
Converting
- Open the lead and select Convert lead.
- Decide whether to tick Also create an opportunity.
- If you ticked it, check the Opportunity Name — it defaults to the company name followed by opportunity — and set the Amount and the Stage; the first open stage is preselected. There is no close date here, so add the dates on the opportunity afterward. Only active open stages are offered, in their configured order.
- Select Convert. Tansi creates a contact, creates or links an account, opens the new contact's record, and creates the opportunity if you asked for one.
After conversion the lead appears only under the Converted saved view. Every other view excludes it, because a converted lead is a contact now. Its status is never edited again. If someone says a lead has disappeared, look there first.
Consent carries across the conversion, and the contact's preferences record the source as carried over when the lead was converted — so the audit trail survives the change of record type.
Things that differ from a contact
- The Messages tab only appears when the lead has a phone number.
- The lead dialog asks for Source only when you create a lead, and Status only when you edit one. The notes box is labeled Message, and there is no fax field.
- The Preferences tab on a lead is headed Communication opt-outs. It shows the preferred contact method (with — not currently usable when the opt-outs rule it out), the preferred language, and two switches: Do not email and Do not SMS. A warning appears above them when the lead can no longer be reached.
- Call uses the built-in softphone when it is available, and your device's phone otherwise.
- On a converted lead the Convert lead button is gone, the status and recency pills are replaced by Converted {date}, and linked people can no longer be changed.
Lead Forms, and the form the public sees
A lead form is a public page strangers fill out to become leads. You can have several, each with its own questions, owner and notifications. One of them is the Default, and booking pages and calendar invites use that one.
The Lead Forms list
/crm/leads/forms lists every form with a Default chip on one of them, a Status of Live or Off, Submissions (30 days) and Last submission (or Never). Row actions are Edit, Duplicate, Set as default and Delete.
Two confirmations are worth reading before you click through them. Deleting warns that the form's public link and embed stop working immediately, though leads already captured are kept. Making a form the default warns that booking pages and calendar invites will use it from now on. And the default form cannot be deleted at all — make another form the default first.
The form editor
The editor's subtitle sets expectations: A public form strangers fill out to become leads. Changes go live the moment you save. Pills along the top show Live or Off, how many of the fields are shown, how many are required, and Link locked where it applies. A sticky bar at the bottom counts unsaved changes and offers Discard.
Six cards, in order:
| Card | What you set there |
|---|---|
| Form fields | Order, show and require each field. Name is tagged Always first. |
| Routing | Who gets new leads and who is told about them. |
| Questions | Extra questions after the standard fields. |
| Sharing | Whether the form is live, its public link, and the embed code. |
| Wording | The title, the intro sentence and the thank-you message. |
| Preview | Desktop and mobile widths, reflecting unsaved changes. |
Form fields
Reorder with the arrow buttons, or focus a row and press Alt + ↑ or Alt + ↓. Name is always shown and always required and cannot be moved off the top — it is how a submission becomes a lead.
The editor warns you: Submissions without an email or mobile number are discarded — enable at least one. This is silent from the visitor's side. They see a thank-you message and you get nothing. Check this card before you publish.
Routing
- Lead owner — who the new lead belongs to.
- Lead source — what the lead's source is set to.
- Notify users and Notify email addresses — press Enter to add an address, up to ten.
- Redirect after submit — an absolute https URL, up to 500 characters. Leave it blank and the visitor sees your thank-you message instead.
- Also keep me updated — pick a mailing list. The picker shows whether the list is single or double opt-in, and explains that double opt-in lists send a confirmation email first.
Questions
Extra questions come in five types: Short text, Long text, Dropdown, Checkboxes and Yes / No. Each can be made Required, and each offers Save answer to lead field, which writes the answer into a lead custom field so it lands somewhere you can filter and report on rather than in free text.
Validation will stop you saving with a missing form name, a redirect that is not an absolute https URL, an invalid notify address or more than ten of them, a question with no text in any language, or a dropdown or checkbox question with unlabeled options.
Sharing and embedding
The Form is live switch is how you take a form down without deleting it: Anyone with the link can submit. Turn off to take the form down without deleting it. Beside it sit the Public link, Copy link, Lock link and Regenerate link…
The confirmation says it outright: Anyone with the current link, including printed QR codes, will get a ‘not found’ page. It also breaks any live website embed until the new code is pasted in.
If the link is going on a business card, a trade-show banner or a poster, use Lock link first. A locked link cannot be regenerated by anyone, which is the point.
The Share & embed panel has tabs for WordPress, Wix, Squarespace, HTML, AI prompt and Link, plus a style choice (inline or floating button), Allowed websites, an accent color with a contrast warning, the form language, a switch for showing the Tansi logo, copy buttons and a live preview.
Embedding stays off until at least one Allowed website exists, and the setting has to be saved before it takes effect on the live site. A form that works in the preview and shows nothing on your website is almost always this.
Embedding needs the Embeddable Forms capability; without it the panel says Embedding on your website is available with Embeddable Forms — ask your Tansi administrator. The floating button's text can be up to 40 characters (blank uses the default). An allowed website can be written as *.example.com to cover every subdomain, and the list has a maximum size. Until the form is saved, the code area reads Save to get your embed code.
What the recipient sees
The public form renders in a branded page with a Tansi logo, a public footer and a language switcher. The visitor sees your title (Contact us if you have not set one), your intro sentence, the fields you switched on in the order you set, and your custom questions after them. Required fields are marked, with the note Fields marked with an asterisk are required. The button says Send.
Field labels the visitor sees are Name, Email, Company name, Website, Address, Address 2, Mobile, Message, City, Province / State, Country, Postal code and Interested in, plus any keep-me-updated box you configured.
After submitting they get Thank you and your message — the default is Thanks — we'll be in touch soon — or they are redirected to your URL.
Things can go wrong at their end too, and the messages are plain: Not found — This form was not found, Not accepting submissions, Too many submissions right now — please try again later, and Please provide an email or mobile number so we can reach you.
The form carries a hidden honeypot field labeled Website (leave blank). Automated submissions fill it in and are dropped without a message. Real visitors never see it.
Creating a form, and who can change the embed
New form asks for a Form name — Only your team sees this name., up to 120 characters — and opens the editor as soon as you select Create. Duplicate, Set as default and Delete need edit access to Leads.
Embedding on a website is a separate capability. If your workspace does not have Embeddable Forms, the share panel says Embedding on your website is available with Embeddable Forms — ask your Tansi administrator. Where it is available, changing the embed settings also needs the lead form embed permission at edit level; the public link works either way.
Custom questions also appear in the Form fields table, tagged Question, so you can order them among the standard fields.
Opportunities
An opportunity is a deal you are working — most often a bid, from solicitation through to award. The list's subtitle is Deals in your pipeline.
The list is a work queue
The default sort is Submission deadline, soonest first, with undated deals last. Overdue open deals render in bold red. This is on purpose — the list answers what is due, not what starts with A.
Columns are Submission deadline, Name, Account, Type, Amount with its currency code, Stage, Probability and Status (Open, Won or Lost chips). The toolbar has a debounced server-side search, an export menu, and a List and Table toggle — Table appears only when your permission level allows it.
A submission deadline is stored and shown exactly as it was typed. It is never converted into the reader's local time, on the list or on the deal sheet. If a bid is due at 2 p.m. in the buyer's city, type 2 p.m. and note the city in the scope summary.
Creating an opportunity
The dialog is titled New opportunity or Edit opportunity, subtitled Track a bid from solicitation through to award. It has a section rail down the left — the arrow keys move between sections, Enter jumps to the first field — and an error summary at the top reading There are {n} problems with this form.
| Section | What you fill in |
|---|---|
| Basics | Opportunity name (required; the helper suggests the convention Client – Short description – Year), Company (required, with New company beside it), and Primary contact. Pick the company first — contacts belong to a company. |
| Solicitation | Opportunity type, RFP or solicitation number, solicitation website (a full validated URL), source, and the set-aside or procurement stream. |
| Value and stage | Bid value, currency, Status, Stage (required) and Probability. |
| Dates | Issue date, questions deadline, Submission deadline (required), submission time and expected award date. |
| Scope | The scope summary. |
| Internal | Owner, team, and a read-only tenant field — Tenant follows its account — change it on the account. |
Probability is set automatically from the stage, and tells you which it is doing: Set to {n}% from the {stage} stage, or Overridden manually once you change it. The submission deadline cannot be before the issue date, and a mistyped submission time blocks the save rather than guessing.
Two toasts worth recognizing: Contact saved, but it isn't linked to this company — link it on the contact to pick it here, and Details not confirmed — status left unchanged, which appears when you set a status but back out of the dialog that collects the award or loss detail.
The opportunity record
Five key figures sit across the top: Bid value, Stage, Submission deadline with a countdown ({n} days to submission, Submission due today, Submission deadline passed), Real margin, and Submission ready showing how many required parts are approved, with a Submitted chip once it has gone. A meta line underneath carries probability, questions due, issued and expected award dates.
When budget lines exist in Pricing, the tile reads from Pricing, before tax. When they do not, it reads as entered on the opportunity. Real margin shows add budget lines in Pricing until there is something to compute from. If the number looks wrong, read the subtitle before you change the figure.
The Required details panel lists the opportunity custom fields an administrator marked required in CRM Settings, and appears only when there are some. It saves as you leave each field, and it opens itself while anything is still missing.
The tabs
| Tab | What is in it |
|---|---|
| Activity | Sub-tabs for Timeline, Tasks, Notes, Chat, Time and Schedule. Schedule is the Gantt of tasks, calls, meetings and billing milestones. |
| Pricing | Sub-tabs for Budget lines, Vendor prices, Price sheet, Contractors and Bid costs. |
| Submission | The checklist, addenda, a Ready to submit? check, the recorded submission and Proposals. |
| Table | Tansi Sheets for this record. |
| Documents & forms | The folder explorer plus any attached Tansi Forms. |
| Custom fields | A display with an Edit values toggle; changes save as you leave a field. A badge counts required fields still missing. |
| Related | Linked records and automatic links. |
| Contract & billing | The contract summary, the billing schedule, and the Contracts and Invoices lists. |
Every pre-redesign tab name survives as a deep link. #timeline, #quotes, #proposals, #rfq, #docs, #invoices and about thirty others redirect to wherever that content now lives. A bookmark from last year will still land in the right place.
Pricing, in outline
- Budget lines nest up to eight levels deep, take quantity and a second quantity inline, move by drag or keyboard, and can be filled from a template. There is a timeline view as well as the table.
- Price sheet keeps revisions, previews formats, Compares two revisions and can Send as quote. Layouts run from Section totals to One total; styles are Classic, Modern, Government price form and One-page summary.
- Guardrails you will meet: the price sheet locks after submission, only a current revision can be sent as a quote, the account needs a billing address before a quote goes out, and a send goes to at most ten recipients.
Each Pricing sub-tab has its own section later in this module, under Bids and pricing, followed by the Submission tab.
Small form details that matter
- Bid value (estimated) can be left blank when the value is not known yet.
- Source suggests earlier sources but accepts a new one typed in.
- Leave Submission time blank and the deadline means the end of that day.
- Changing Status in the dialog tells you what saving will do: reopen the deal into the chosen stage, ask for award details, or ask for a loss reason.
Email and SMS go to the account
The Email and SMS buttons on an opportunity write to the account's email address and phone number, not to the primary contact. They are unavailable when the account has none, and SMS also needs a workspace texting number.
The Lost banner and the Award card
A lost deal always shows a red banner — Lost — {reason}, or no reason recorded — with any loss notes. Editors see Add reason or Edit on it, so a deal closed without a reason can still get one. Until it does, Reports file it under Lost — no reason recorded.
A won deal shows an Award card with Contract #, Awarded value, Contract type, Award date, Contract dates and PO #, plus the signed contract file if one was uploaded. Its Edit button opens Edit award details.
When the Contract & billing tab appears
The tab shows when the deal is Won, when contracts or invoices already exist, or when you can create them. A view-only reader on an open deal with nothing billed will not see it.
Deleting an opportunity
Delete is permanent — This can't be undone. If documents are attached, the dialog lists them, warns that deleting removes access to them including any signature links already sent, and will not let you continue until you tick I confirm I have copies of these documents. Billable time entries stay on the account's billing ledger. Delete is unavailable once the deal has become a project.
Won, lost, and becoming a project
A deal ends one of two ways, and Tansi asks for different things depending on which.
Marking a deal won
Won opens a dialog asking for the Contract # / Award # and the Awarded value — both required — plus the award date, contract type, contract start and end dates, an optional PO number, and an optional upload of the signed contract. Saving fires Tansi-logo confetti, which is the only moment in the CRM that does.
Mark Won stays disabled until the contract number is filled and the awarded value is more than zero. Contract type offers Fixed price, Time & materials, Standing offer and Cost-plus among others. The signed-contract upload takes PDF, Word or image files. Canceling the dialog cancels the close — whether you started from the button, the pipeline board or a menu. On a won deal the same dialog reopens as Edit award details, without the upload.
Marking a deal lost
Lost states what it is doing — Marking {name} as lost. A loss reason is required. — and asks for a Loss reason from the picklist plus optional Details: What happened? Who won, what tipped it, what to do differently.
The built-in reasons are Price, Timing, Incumbent, Scope mismatch, We didn't bid, No decision made, and two catch-alls. Your workspace can add its own. Administrators see a Manage loss reasons link straight to the picklist; everyone else sees Need a different reason? Ask a CRM admin to add it. Fill this in honestly — it is what the Why deals were won and lost chart on the Reports page is built from.
Converting a won opportunity to a project
Once a deal is won, Convert to Project appears, and after conversion the button becomes Open project. A project mirrors the opportunity layout with nine tabs: Activity, Milestones, Pricing, Submission, Table, Documents & forms, Custom fields, Related and Contract & billing. It is reached from the won opportunity or from the account's Projects tab — there is no Projects entry in the navigation.
Once an opportunity has become a project, its Edit, Won, Lost, Delete and New buttons go away, and the submission reports This opportunity was converted to a project, so its submission is read-only. Row actions on existing contracts and quotes — send, void, sign — still work. Do your corrections before you convert.
Rows that came from the source opportunity appear on the project with a From the opportunity chip and are read-only there. A deal that is linked to a project also cannot be moved on the pipeline board.
The Convert dialog asks for a Project name, an Owner company (required — This tenant has no companies yet — create one under Companies first. if there are none), a Project manager, a Start date and an Expected end date no earlier than the start. A table headed Copied to the project (independent afterwards) lists the contract number, contract value, contract type and contract dates. If the award details are missing, the dialog stops you: Record the Contract # and Awarded Value in the Award section before converting. An opportunity converts to one project only.
A project's Milestones tab uses a short dialog: Milestone (required), Due date, Status (Not started, In progress or Complete) and Value (optional). These delivery milestones are separate from the billing milestones on an opportunity's Contract & billing tab.
Before you select Convert to Project
The conversion dialog needs a Contract # and an Awarded value on the Award card, an Owner company, and start and end dates. The full walk-through, and everything on the project record afterward, is in the section on the project record.
Deleting an opportunity
Delete on an opportunity opens an impact check before anything happens: Are you sure you want to delete {name}? This can't be undone. If documents are attached, it lists them and warns Deleting removes access to them, including any signature links already sent. Download or export anything you still need first. — and Delete opportunity stays disabled until you tick I confirm I have copies of these documents.
It also names what goes with the deal — Also removed from this opportunity: 2 quotes, 1 invoice, 14 timeline entries… — and what stays: 3 billable entries stay on the account's billing ledger.
A client halfway through signing a contract loses the page the moment the opportunity is deleted. Void or finish paperwork first, and download signed copies before you delete.
The Pipeline board
/crm/pipeline shows your open deals as a board of stage columns. Its subtitle says both halves of what it does: Drag deals across stages. Drag a Won/Lost deal back onto a stage to reopen it.
The summary strip
Four figures: Open deals, Total value, Weighted and Due this week, with the note Weighted value is each deal multiplied by its stage probability — the number to forecast from.
Nothing in the pipeline summary includes won or lost deals, even though Won and Lost columns are on the board. If the total looks low against what you know you have closed, that is why. The Reports page is where closed business is counted.
Finding and arranging deals
Search deals matches name, account, owner, value and date. The Owner filter offers Everyone or a named person. Sort cards by offers Value, high to low, Submission deadline or Days in stage — the last is the one that finds deals nobody has touched.
There is one column per open stage, in rotating accent colors, plus Won and Lost. Any column can be collapsed to a vertical strip showing its name and count, which is how you fit a long pipeline on one screen.
Moving a deal
Drag a card to another column, or open the card. Selecting a card opens a right-hand deal sheet, and the stage picker there — including Won and Lost — is where closing happens.
From the keyboard, Ctrl + ← and Ctrl + → move the focused deal one stage. The announcements tell you when a move will not work: {deal} is already in the last open stage. Press Enter to mark it Won or Lost., {deal} is closed. Press Enter to reopen it from its panel., and {deal} is linked to a project and can't be moved here.
A deal linked to a project refuses to move by either method. That is the same rule the read-only conversion enforces, showing up in a different place.
With no stages configured the board says No open pipeline stages. Add stages under CRM Settings.
The deal sheet shows the deal's name and a summary line, then Stage — one button per open stage, the current one marked Current — and Close the deal with Won and Lost. Deal detail lists Account, Owner, Value, Probability and Weighted (open deals), Submission deadline (as typed), Expected award, Closed (closed deals) and Source. Open opportunity goes to the record; Edit deal opens the edit form. Choosing Won or Lost here opens the same award or loss dialog as everywhere else.
Board or table
The header has a Board and Table switch. The table lists every visible deal with Deal, Account, Stage, Value, Probability, Weighted, Owner, Submission deadline and Expected award — the fastest way to read deadlines down one column.
What the cards and columns hold
- The Won and Lost columns only show deals closed in the last 30 days. Older closed deals are still in the CRM — on the Opportunities list and in Reports.
- A card shows the deal, its account, its amount and either its probability or Closed {date}.
- Shading marks urgency, always with words: Due in 5 days, Due tomorrow, Deadline passed 2 days ago, or Award expected in 10 days when there is no deadline. The legend reads Deadline passed or within a week and Deadline within three weeks.
- Collapsed columns open again when you reload the page.
- On a Mac, Cmd works in place of Ctrl for moving a card.
- Reopening a closed deal keeps its old award or loss details until the next time it closes.
The summary strip, column totals and card amounts are shown in your own display currency and add the amounts together, whatever currency each deal is in. If your pipeline mixes currencies, use Reports, which keeps currencies apart and says what it left out.
My Activities
/crm/activities is your open follow-ups and tasks in one list, with a back link to the CRM home page. Its subtitle is Your open follow-ups and tasks.
The buckets
Four buckets across the top double as filters: All open, Overdue in red, Due today in amber, and Next 7 days. Selecting one narrows the table below rather than opening a new page.
A task is due on a day, not at a moment. Today means the server time zone's today — which is the same rule the Overdue and Due today buckets use. A task set for today does not become overdue at a particular hour; it becomes overdue tomorrow.
The table
| Column | What it shows |
|---|---|
| Activity | An icon, the subject, and a preview of the body. |
| Related to | A link to the lead, contact, account, opportunity, project, quote or invoice it belongs to. |
| Assigned by | Who gave you the task. |
| Due | The due date. |
Search matches the subject, the notes and the related record. There is an export menu. Selecting a row opens the activity detail dialog, where you can work the task without leaving the list.
Clearing tasks from the list
- Each row has a Mark done button. Tansi confirms with Activity marked as done. and the task leaves the list.
- Next 7 days counts today and the six days after it.
- Selecting the bucket that is already active returns you to All open.
- Tasks with no due date are listed last and show No due date.
- When a filter leaves nothing, the page says Nothing matches your filters and offers Clear filters.
The project record
A project is what a won opportunity becomes once the work is real. The opportunity was about winning; the project is about delivering. Tansi keeps the two linked, so you can always step back to the bid that started it, but from the moment of conversion the project has its own figures, its own team and its own milestones.
There is no Projects entry in the menu. You reach a project from the won opportunity (Open project), from the converted banner on that opportunity, or from the Projects tab of the account.
Who can change a project
Projects follow the Opportunities permission, not a permission of their own. Anyone who can edit opportunities, at the edit or edit-own level, can edit a project. Someone with view-only access sees every figure but the Save button stays unavailable. If your access is limited to your own records, you can only change a project's budget when you are its project manager.
Converting a won opportunity
Convert to Project appears on an opportunity once it is Won, if you have edit rights and it has not been converted already. One opportunity makes one project.
- Make sure the Award card on the opportunity shows a Contract # and an Awarded value. Without both, the dialog only says Record the Contract # and Awarded Value in the Award section before converting. Use the card's Edit button to add them.
- Select Convert to Project.
- Check the Project name (it starts as the opportunity name, up to 200 characters).
- Pick the Owner company — the company in your organization that will deliver the work. If there is only one, it is chosen for you. If the list is empty, the dialog says This tenant has no companies yet — create one under Companies first.
- Optionally pick a Project manager.
- Set the Start date and Expected end date. They start from the contract dates on the award, or today and one year later. The end date cannot be before the start date.
- Read the table headed Copied to the project (independent afterwards) — contract number, contract value, contract type and contract dates — then select Convert.
Tansi confirms with Project {number} created. The opportunity becomes read-only and shows Converted to project {number} on {date} — this opportunity is read-only.
The contract details are copied once. Changing them on the project later does not change the opportunity, and the opportunity can no longer be edited anyway. Get the award details right before you convert.
The top of the record
The header shows the project name with its project number underneath, a back arrow to the source opportunity, and a Save button. Five tiles sit below it:
| Tile | What it shows |
|---|---|
| Contract value | The copied contract value and its currency. |
| Status | The project's current status. |
| % complete | A whole number from 0 to 100. |
| Budget / actual | The budget against the actual cost to date. When costs have been recorded against the project, the actual figure is calculated and a caption says so. |
| Invoiced to date | Calculated from the project's invoices when there are any, otherwise the figure typed in by hand. |
A Contract card repeats the contract number, type, dates and client, links to Source opportunity: {name}, and lets an editor pick the account the project belongs to.
Fields you keep up to date
| Field | Notes |
|---|---|
| Status | Chosen from the project status list. A new project starts at Planning. |
| % complete | 0 to 100. |
| Budget | The estimated budget. |
| Actual cost to date | A manual figure, used when no costs are recorded against the project. |
| Invoiced to date | A manual figure, used when there are no project invoices. |
| Project manager | One person from the workspace. |
| Delivery team | Several people from the workspace. |
| Project notes | Free text, up to 2,000 characters. |
Unlike the Required details panel on an opportunity, nothing here saves as you leave the field. Change the status, the percentage and the notes, then select Save in the header. Tansi confirms with Project saved. Leaving the page first loses the changes.
Milestones
The Milestones tab exists only on projects. Add milestone asks for the Milestone name, a Due date, a Status — Not started, In progress or Complete — and an optional Value. The table lists Milestone, Due, Status and Value, with Edit and Delete on each row for editors. With none yet, the tab reads No milestones yet.
The Delete button on a milestone row removes it immediately, with no confirmation and no undo. Edit the status instead if the milestone is only postponed.
The other tabs
| Tab | What is different on a project |
|---|---|
| Activity | Timeline, Tasks, Notes, Chat and Time. There is no Schedule sub-tab. |
| Pricing | Two sub-tabs only: Budget and Quotes. |
| Submission | Proposals for the project. |
| Table | Your project sheets. When there is a source opportunity, a switch shows its sheets instead, read-only. |
| Documents & forms | The project's documents and forms, plus the opportunity's forms listed read-only underneath. |
| Custom fields | Project custom fields, edited in place, with the opportunity's custom field values shown read-only below. |
| Related | Linked records, as on any CRM record. |
| Contract & billing | Contracts and Invoices. |
New quotes, invoices, contracts and proposals on a project need a linked account. Until there is one, a prompt replaces the New buttons. Pick the account in the Contract card first.
What every CRM record gives you
Accounts, contacts, leads, opportunities and projects share a set of surfaces. Learn them once and they work the same everywhere.
The activity timeline
The composer is headed Log an activity and offers chips for Email, SMS, Call, Log call, Meeting, Task, Track time and More — which holds notify a teammate and log other activity. The note box takes Ctrl + Enter to save.
The feed groups by day with Today and Yesterday headings, shows relative times, marks the campaign a message came through with via {campaign}, attributes automated entries to Tansi (system), shows call lengths, marks a Shared note as written on another record, and turns quote and invoice numbers into links. Filter buttons across the top offer All and one button per activity type.
Unsaved note text survives a lost connection. You do not need to copy a long note into a text editor before you trust the network.
That composer is the layout on accounts and leads. Contacts show the history without a composer, and opportunities and projects use a toolbar headed Activity with Email, SMS, Call, Meeting, Note, Task, Track time, Notify and Other. When the browser phone is available, Call opens Call now and Log call; Meeting always opens Meet now and Schedule meeting. On entries, a pin marks a pinned note and an Open flag marks an unfinished task. The section The activity timeline, in every layout covers all of this in detail.
Notes, and notes shared across records
Each note can be Pinned, Edited, Deleted and linked to other leads and contacts. A linked note shows Also on: {x} or Also on {n} records, and Written on: {x} where it started. The empty state explains what notes are for: Notes are shared with your team — capture context everyone should see, like how this account prefers to be invoiced.
Unlink takes the note off this record only. Delete warns This note also appears on {n} other record(s). Deleting removes it everywhere. This can't be undone. Read the count in that sentence before confirming.
Documents
A folder tree with a breadcrumb and the open folder's files, plus New folder, Rename folder, Delete folder, Move folder to…, Move ticked files to… and Search all documents.
Tansi creates and maintains its own folders — RFP documents, Addenda, Vendor quotes, Submission, Receipts and Contracts — plus a dated snapshot folder for each recorded submission. The notes shown in place explain the rules: a Tansi folder cannot be renamed, moved or deleted, though you can add your own subfolders inside it; an internal-only folder is never shared with the client; and a submission snapshot cannot change, because it is a copy of what was handed in.
Folder names have a length limit, cannot contain \ / : * ? " < > |, cannot duplicate a sibling and cannot nest past the depth limit. Only an empty folder can be deleted, a folder cannot go inside itself, and a file a client shared with you cannot be filed into Receipts.
Dropping files on the area marked Drag & drop documents here (or clicking it) uploads several at once, up to the per-file size shown under it. The list shows each file's Name, Kind (Signed contract or Document), Size and Uploaded date, with Download and Delete. Delete acts at once, without a confirmation.
Two switches control who sees a file. Private — Private documents are not emailed or shown on the public page. — and, where the client portal applies, Client can see. Receipts are always internal and their switches are locked. A file the client uploaded shows Theirs already.
A file saved from Tansi Chat keeps what came with it: its description, a Captions (WebVTT) link, a collapsible Transcript, and a From chat link back to the message it was shared in.
Move folder to… and Move ticked files to… open a list of folders with Move here; folders that cannot take the move are marked — can't go here. Deleting a folder asks Delete the folder «{name}»? It's empty, so nothing else goes with it. with Yes, delete or Keep it.
Related records and attached forms
Related holds Link a record and Unlink, with an empty state explaining the point: link a project, ticket, opportunity, account or contract so everyone working this record can jump straight to it. A row you cannot open reads (unavailable — may be in another tenant or removed).
Forms lists attached Tansi Forms with a summary of how many are assigned and complete, columns for Form, Required, Due, Status and actions, and statuses running from No owner / pending through Submitted — awaiting approval to Approved or Rejected — needs resubmission.
Link a record searches Projects, Opportunities, Accounts and Contracts — and Support tickets where your workspace has Support — and takes an optional note. Attach form picks the form and sets Required, Requires approval and an optional due date. Both are walked through in Custom fields, related records, forms and other panels.
The Table view
The Table view is the Table layout of the Leads, Contacts and Opportunities lists — one row per record. (A record's own Table tab is Tansi Sheets, a separate tool.) Your tabs are yours — New tab, Share with my team, Delete tab, and Duplicate to my tabs for a tab somebody else shared. The column menu offers Group by this column, Sort A-Z, Sort Z-A, Hide column and Fit to contents.
The warning on the dialog says it: This column is added to every Tansi record of this type and appears on the record's detail page. A new column is a tenant-wide custom field, not a personal one. Hide a column you do not want to see; do not add one to try it out.
Sharing rows outside the organization
Share rows sends a read-only table to someone outside Tansi. The dialog states how many rows are going, which columns the recipient can see, who the recipient is, and when the link expires. Shared links lists every share with its recipient, expiry, last opened time — the expiry date while the link is live, or Expired or Revoked — and a Revoke.
There is deliberately no never option in the Expires picker, because a perpetual link is not a share. Plan for the expiry: if a client needs the data permanently, send them a file rather than a link.
Every bad token on a shared table — missing, expired, revoked or deleted — produces the same message: This link is no longer available — Ask the person who sent it for a new link. That is a security choice, not a vague error. Somebody guessing at tokens learns nothing about which ones exist.
The link appears once, in the dialog, right after you create the share — copy it then. Expiry choices are 7, 14, 30 or 90 days, starting at 30, and internal columns such as owner and notes are never offered for sharing. Share rows and Add column each need their own CRM permission at Edit.
The client portal strip
The strip reads either Client portal is on · {n} invited · {m} items shared or Client portal is off — nothing is visible outside your team. See what they see opens a preview, and Client access opens the dialog with an on/off switch, an invited table (Person, Role, Expiry, Access) and an Invite someone form taking a name, email, role, expiry and optional message.
The access dialog states it before you turn the portal on: costs, stage history and internal notes are never included. Only the items it lists become visible.
A portal link is personal. The page itself warns the recipient This link is personal to you — please don't forward it. If several people at a client need access, invite them individually rather than letting one link circulate.
While the portal is off, the strip also counts items that are marked shared and waiting. On an opportunity that has become a project, the strip says the portal is managed on the project and links there instead of offering controls. The invite Role matters: Viewer reads, Contributor can also post notes, upload, raise requests and ask for meetings, and Signer also sees signature requests sent to their email. See Sharing with the client, item by item.
The activity timeline, in every layout
Every account, contact, lead, opportunity and project keeps one activity history. What changes from record to record is the layout around it. Knowing which layout you are looking at saves a lot of hunting for buttons.
Three layouts
| Where | Layout | What you get |
|---|---|---|
| Accounts and leads | Composer | A Log an activity panel with chips for Email, SMS, Call (it reads Log call when the browser phone is not available to you), Meeting, Task, Track time and More, then a note box labeled Note about {name} with Save note. Ctrl + Enter saves the note. On a lead, a link picker sits under the box so the note can also land on other people. |
| Contacts | Feed only | The history with its filters and clickable entries, but no composer. Notes, email, texts, calls and meetings are started from elsewhere on the contact page. |
| Opportunities and projects | Toolbar | A heading Activity with buttons Email, SMS, Call, Meeting, Note, Task, Track time, Notify and Other, above a vertical timeline. |
When the browser phone is available to you, Call is a menu with Call now and Log call; otherwise it logs a call straight away. Meeting is a menu with Meet now and Schedule meeting. In the composer, More holds Notify a teammate and Log other activity. Track time only appears when you have the time tracker.
When a button is grayed out
- Email is disabled when the record has no email address.
- SMS is disabled when there is no phone on file, or when the workspace has no texting number. Its label says which: Send SMS — no phone on file, or a tooltip about the workspace number.
- Notify is unavailable until the page knows who you are acting as — usually a matter of the page finishing loading.
Both meeting buttons need the workspace to have Tansi Meetings. Where it does not, they quietly open the ordinary Log activity dialog with Meeting pre-selected. Nothing is booked and no invitation goes out — you are only writing down that a meeting happened. If you expected a calendar invite, check with your administrator whether Meetings is turned on.
Reading the feed
Entries are grouped under Today, Yesterday or the full date. Recent times read just now, 12 min ago or 3 h ago; older ones show the clock time, and pointing at a time shows the full date. Automated entries are signed Tansi (system).
- A pin marks a Pinned note; an Open flag marks a task that is not done.
- A call shows its length, such as 4 min call.
- A message sent by a campaign shows via {campaign}, linking to that campaign.
- On a lead or contact, a note written on another record shows a small shared icon with the tip Shared note — written on another record.
- On a project, entries that belong to the source opportunity carry the From the opportunity chip and open read-only.
- On an account, quote and invoice numbers in the text become links.
Selecting an entry opens its detail dialog, described in the next section.
Filtering
When a record has more than one kind of activity, filter buttons appear: All plus one button per activity type actually present, each with its count. There is no separate filter for pinned notes or open tasks — those are flags you see on the entries themselves. On a lead, the page announces how many entries the filter left, which helps when you are working by keyboard or screen reader.
Which entries the client can see
On opportunities and projects, each shareable entry carries a chip that reads Internal only or Shared with client. Selecting the chip flips it. It only matters once the client portal is on; until then nothing leaves your team. Notifications and custom activity types show an Internal always icon instead — they can never be shared. If you can only view the record, or the opportunity has been converted, the chips stay visible but do nothing.
The empty state tells you what the panel is for: No activity yet — Add a note above, or email, call or text — every action is logged here. On the toolbar layout it reads Use the buttons above to email, call, note, or notify — every action is logged here.
Logging, editing and notifying from the timeline
Four dialogs do most of the work behind the timeline buttons. Each one writes an entry, so whatever you do here is visible to the team afterwards.
Log activity
Opened by Log call, Task, Note, Other or Log other activity. It opens with the matching type already chosen.
| Field | When it shows | Notes |
|---|---|---|
| Type | Always | The activity types from your workspace picklist, including any custom types an administrator added. |
| Direction | Calls | Outbound or Inbound. |
| Subject | Always | Required. Save does nothing until it has text. |
| Notes | Always | Free text. |
| Link to other leads/contacts | Notes on a lead or contact | The note also appears on each person you pick. People saved as this record's linked people are ticked for you; untick anyone who should not get this note. |
| Outcome (optional) | Calls | Placeholder e.g. Left voicemail, Connected — sending quote. |
| Due, Reminder | Tasks | Calendar dates. A task is due on a day, not at a time. |
Success shows Activity logged.
The detail dialog
Selecting any entry opens it in full: the type, direction, a Missed or Voicemail chip on calls, the task's status, the subject and body, Outcome:, Answered by {name}, Duration:, an audio player when the call was recorded (or left a voicemail), the due and reminder dates, and Logged by {name} with the time — plus Edited by when someone changed it.
| Button | When it appears |
|---|---|
| Open record | Always. Jumps to the lead, contact, account, opportunity or project the entry belongs to. |
| Open the thread | Text messages, on pages that have a conversation tab. |
| Mark done | Open tasks. |
| Pin / Unpin | Notes. A pinned note shows in the record's Key notes panel. |
| Link to other leads/contacts | Notes on a lead or contact. |
| Edit, Delete | Notes, tasks, calls and meetings. |
Sent emails, texts and notifications are delivery records: they have no Edit or Delete, because what was sent cannot be unsent. Entries that belong to a project's source opportunity open view-only.
Edit turns the dialog into a form with Subject, Notes, Outcome (calls and meetings) and Due and Reminder (tasks). Delete asks inside the dialog — Delete this note? This can't be undone. — with Yes, delete. Messages: Activity updated., Activity deleted., Subject is required.
Sending an email or a text
Email and SMS open a short dialog titled Send email or Send SMS: To (email) or To (phone), prefilled from the record, a Subject for email, and a six-line Message. A blank subject goes out as (no subject). Recipient and message are both required.
A text is sent from the record's workspace number, not from your own phone, and is logged on the timeline. Results: Email sent., SMS sent., or Send failed. Check the address/number and try again.
Notify a teammate
Notify (or Notify a teammate) sends one colleague a nudge about this record. The dialog says exactly what happens: They get an in-app notification and an email, and it's logged on the timeline.
- Pick the person in Notify. The list holds the active users of the record's workspace; it starts on the record's owner, or on you if the owner is not in the list.
- Check the Title. It starts as Follow up: {record name}.
- Add a Message if the title is not enough.
- Select Send. You see Notification sent to {name}.
The in-app notification links straight to the record. The email is best effort: if it fails, the in-app notification and the timeline entry still stand. The entry is logged as a Notification ending — notified {name}, and it is always internal. If nobody else is in the workspace you will see No teammates found in this tenant to notify.
A notification is a tap on the shoulder. It does not appear in anyone's task list or carry a due date. If the follow-up has to happen by a certain day, add a Task and assign it instead.
Calls, meetings, booking links and the timer
Logging a call on an opportunity
Opportunities have their own activity bar with Log a call (when you can edit the opportunity). Its dialog is richer than the general Log activity dialog because a call on a bid often counts as time and may need to be visible to the client.
| Field | What to enter |
|---|---|
| Direction | Outbound (we called) or Inbound (they called). |
| With | A contact on the opportunity's account, or nobody (No contact picked). |
| Subject (optional) | Leave blank and it becomes Outbound call or Call with {name}. |
| Length (minutes) | 0 to 1440. 0 if you don't know. |
| Outcome (optional) | Connected, Left a voicemail, No answer, Call back requested or Wrong number. |
| Notes | What was said. |
| Also log the call's length as time | Adds the minutes to the opportunity's Time tab. Needs a length above zero: Enter the call's length to log it as time. |
| The client can see this call on their portal | Shares the entry on the client portal. |
Select Log the call. If the call saves but one of the extras fails, you are told which: The call was logged but stays internal: it couldn't be shared with the client. or The call was logged, but its time wasn't saved. Log the time from the Time tab. Picking someone from another company is refused: That contact isn't on this opportunity's account. Pick another.
The timer on an opportunity
The same bar shows the time tracker for this opportunity:
- No timer running. with Start timer.
- Timer running on this opportunity: 0 h 25 min with Stop and save time and Discard timer.
- A timer is running on {record}. Stop it there first. — only one timer runs at a time, and the bar names where yours is.
Stopping saves the minutes as time on the opportunity — Timer stopped: 25 min saved as time. — and they appear on the Time tab and in the bid costs. Discarding asks first: Discard the running timer? The time it has counted won't be saved. with Yes, discard or Keep it running. The Track time button on other records opens Track time on this record instead, and the running timer then lives in the tracker at the bottom-right of the screen.
Meet now
Meet now starts an instant Tansi Meet call from the record. Give it a Title, then choose how the other person hears about it:
- Email the join link to {email} — shown when the record has an email.
- Text the join link to {phone} — shown when it has a phone; disabled if the workspace cannot text.
- Add a message (optional) — Shown to the recipient above the join button. A counter shows how much room is left.
If the person also has a Tansi login linked to the record, their Tansi rings. With no email or phone on file you see No email or phone on this record — the join link will be on the timeline to copy. Billing fields underneath let you mark the meeting billable. Start meeting logs a Meeting entry with the join link and opens the call.
Schedule a meeting
Schedule meeting opens Book meeting. Clicking outside the dialog does not close it, so you will not lose a half-filled invitation.
| Field | Detail |
|---|---|
| Title | Starts as Meeting with {name}. Required. |
| Date, Start time, Time zone | Required. The time is read in the zone you pick. |
| Duration | 15, 30 or 45 minutes, 1 hour, 1.5 hours or 2 hours. |
| Remind me, Reminder | 15 minutes, 30 minutes, 1 hour, 4 hours or 1 day before. |
| Description | Sent to attendees with the invitation. |
| Attachments | Add files to send with the invitation. |
If the slot clashes with your calendar you see This overlaps with something on your calendar: {event}. You can still book it anyway. If the record has no email, This record has no email, so the contact won't receive an invite. Book meeting confirms with Meeting booked. and writes Scheduled for {time} ({zone}). With: {who}. Join: {link} on the timeline. Partial results are spelled out — for example Meeting booked, but it could not be added to the timeline.
The Meet menu and booking links
On contact and lead cards, and in the reach sheet, the Meet button opens three choices: Meet now (Start an instant meeting), Schedule meeting (Pick a date and send an invite) and Send booking link (Let them pick a time from your availability).
Send booking link offers only your own active booking pages, shown as {title} ({minutes} min). If you have none, it says You have no active booking pages yet. and links to Manage booking pages. Enter a Recipient email and select Send email (Booking link sent), or choose Copy link only to get the link in a Booking link box and paste it wherever you like.
Where the browser phone is available, a Call action can also ask first: Call now to dial from Tansi, or Log call to record a call you made some other way.
The reach sheet and text conversations
On contacts and leads — from a card in the list, or from Contact on the record — a sheet slides in from the right. It answers one question: how should I reach this person right now?
The banner
Under the name and job line, a banner reads Best way to reach {first name} with the reason, for example Email is on file and they're opted in — the reliable way to reach them. or They asked to be reached by text, and they haven't opted out. When the preference comes from the account, it says so: {account} prefers email for its contacts, and they haven't opted out.
When something is wrong, a warning replaces the banner instead of dressing a bad option up as a recommendation:
| Warning | What it means |
|---|---|
| No contact details yet | No phone and no email. Add a phone number or email to start reaching {name}. |
| No usable contact details | No email and no number that receives texts — a phone call is the only way left. |
| Unsubscribed from notifications | They opted out of email, text or both. If there is a number, a phone call is the only way left; if not, there is no way to reach them right now. |
| Preferred method unavailable | They (or their account) asked for a channel you cannot use, and why: …but there's no email address on file. Suggesting text instead. |
The channel rows
Under Reach {first name} are four rows: Call (logs a call), Text, Email and Meet (Tansi Meet — opens the Meet menu). The suggested row carries a Best badge. A row you cannot use is disabled and says why: No phone number on file, Opted out of SMS, This number doesn't receive texts, No email on file, Opted out of email, or the workspace's texting problem.
Pinning a preferred method
The pin beside Call, Text and Email records what the person told you they prefer. Select a pin to set it — {first name} now prefers email. — and select the lit pin again to clear it — Cleared {first name}'s preferred contact method. Meet cannot be preferred. An account-level preference shows as an inherited pin; selecting it sets the preference on this person directly.
Recording “they want email” is allowed before an email address exists. The sheet then shows Preferred method unavailable and suggests something else, so the wish is kept and nobody is pointed at a dead end. Add the address and the banner corrects itself.
Below the rows are Details and Notes, and a button to open the full record (hidden when you are already on it).
Text conversations
Accounts, contacts and leads have a messages tab holding the SMS conversation as chat bubbles — theirs on the left, yours on the right — each with its time and delivery status. Type in Type a message… and select Send.
- No phone number on this record. — add one first.
- No messages yet. — the first text starts the thread.
- This record has opted out of SMS. — the box is disabled. Respect it; the opt-out is part of the consent record.
- A workspace with no texting number disables the box with a message saying so.
- Message not sent — check the number or SMS opt-out. — the send failed.
Tasks, time, key notes and the schedule
The Tasks sub-tab
Opportunities and projects have a Tasks sub-tab under Activity. These are real platform tasks: the empty state says so — Tasks added here also appear in the assignee's My Tasks and on their calendar. They are separate from the Task activity you log on the timeline, which stays on the record only.
Add Task opens New Task with the record's workspace locked in and the task already linked to the record. The table shows:
| Column | What it shows |
|---|---|
| Title | Struck through when done; the first 100 characters of the description below. |
| Assigned To | Who has it. |
| Due | A chip — red when overdue, amber when due soon. |
| Priority | Urgent, High, Medium or Low. |
| Status | For example In Progress, On Hold, Awaiting Approval, Completed or Cancelled. |
| Client | Shown when the client portal applies: a Client can see switch, or Theirs already for a task the client raised. |
Open work sorts first, then by due date. The row buttons mark a task done, edit it, or delete it after Delete “{title}”? This can't be undone. On a project, the source opportunity's tasks are listed too, with the From the opportunity chip and no buttons.
The Time sub-tab
Leads, opportunities and projects have a Time tab. Three figures sit across the top: Logged time in hours, Amount per currency, and Missing rates, which turns amber when any entry has no rate.
Log time opens Log time against this record:
| Field | Notes |
|---|---|
| Worker | Required. The account's team plus the record owner. Names without a rate read — no rate set, and the dialog shows Standard rate: {rate}. |
| Date | Defaults to today. |
| Minutes | At least 1. Starts at 60. |
| Description | Up to 300 characters. |
| Override rate | Leave blank to use the worker's standard rate. |
The table lists Date, Who, Description, Time in hours and Amount, or a No rate chip — No rate was set for this person when the time was logged. The export is titled Time Log.
There is no edit for a time entry. If the minutes or the date are wrong, delete the entry and log it again. Only entries typed in by hand can be deleted here; time that came from a meeting or a timer stays.
A lead that has not been converted has no account and so no team rates. Its time is still logged — it shows No rate until there is one.
Key notes
Pin a note and it appears in the Key notes panel near the top of the account, lead, opportunity or project, with its author and age. It is the place for the things everybody should see first — invoices go to the regional office, no deliveries before 7 a.m., prefers a phone call to email. Each key note has an Unpin button. The panel disappears when nothing is pinned.
The schedule (Gantt)
An opportunity's Activity tab has a Schedule sub-tab. Its help says how to read it: Tasks run from their start to their due date. Calls, meetings and billing milestones are one-day diamonds. A table on the left lists everything with What, Who, Start, End and Status.
- Kinds: Task, Follow-up, Call, Meeting and Billing milestone.
- States: Open, Done, Overdue and Logged.
- Open items only hides finished work.
- Zoom with Weeks, Months or Quarters. Today and Bid due are marked on the chart.
- Point at or tab to a bar to see its details; items with no dates are listed as No dates.
Empty: Nothing scheduled yet. Tasks, calls, meetings and billing milestones show here.
Account team, rates and billing
Two account tabs turn tracked time into money. Team says who works the account and what an hour of their time is worth. Billing lists every billable entry against the account and adds it up. If a worker has no rate, their time is recorded but bills nothing.
The Team tab
The heading summary reads 4 workers, or 4 workers · 1 missing a rate. The table caption is Workers assigned to this account.
| Column | What it shows |
|---|---|
| Worker | The person. |
| Role | Their role on this account, or Not set with an Add role button. |
| Rate | {amount}/h, or No rate set with a Set rate button. |
| Notes | Free text, or No notes. |
| Row actions | Edit and Remove. Removing asks Remove worker — This can't be undone. |
Add worker opens a dialog with Worker (a teammate from the account's workspace), Role, Hourly rate, Currency (three letters, CAD if left blank) and Notes. Once added, the worker cannot be swapped — editing changes only the role, rate and notes. To put someone else in the seat, remove the row and add the new person.
The empty state explains why this matters: Add who works this account and their rates, so tracked time can bill.
Syncing rates with a project
The Rates menu has Import from project… and Export to project…. Import pulls the project's standard rates onto this account; export pushes this account's rates out to the project. Pick the project in the small dialog and confirm with Import or Export. The result reads Applied 5, skipped 1, followed by the reason for each skip.
A project has to be linked to the account first. Otherwise you see No projects linked to this account yet — link one from the Related tab first.
The Billing tab
Pick a Billing month to narrow the ledger, or select All time. Three figures sit on top: Billed time in hours, Amount per currency, and Missing rates, with a caption such as 2 workers have no rate set.
| Column | Notes |
|---|---|
| Date, Worker | When and who. |
| Source | Manual for typed-in entries, Meeting for time from a billable meeting, and so on. Meeting entries are read-only here. |
| Description | What was done. |
| Actual, Billed | Minutes worked and minutes charged. |
| Rate, Amount | Or a warning: Missing rate — set a worker rate to bill this entry. |
| Row actions | Delete, after This can't be undone. |
Add entry opens Add billing entry — the same worker, date, minutes, description and override-rate form as a record's Time tab. The export is titled Account Billing and notes the filter, such as Month: 2026-10.
When the ledger is empty but workers lack rates, the page says Nothing has been logged against this account. 2 workers have no rate set, so time tracked for them will not bill. and offers Set the missing rate. An entry keeps the rate it was logged with, so set rates first and log time after.
Custom fields, related records, forms and other panels
Custom fields on a record
The Custom fields tab lists every active field your administrator set up for this kind of record, set or not. The heading summary reads 6 fields · 4 set. A field with no value reads Not set with an Add button; checkboxes read Yes or No. On accounts, contacts, leads and projects, Edit values (and every Add) opens the record's edit form, where the fields sit in an Additional fields block. On an opportunity, Edit values instead turns the tab itself into inputs for every field, of any type: Changes save as soon as you leave a field. A badge on the tab counts required fields that are still empty.
With none defined you see No custom fields yet — Your admin can add fields for this record type in CRM settings.
On an opportunity, the Required details panel lists only the required fields, opens by itself while any are missing, and edits them in place, saving as you leave each one: {field} saved, {field} was not saved: {reason}, or {field} is required.
The Additional fields block in the account, contact, lead, opportunity and project forms only draws inputs for Text, Number, Date, Checkbox and Choice list fields. A field of type Email, Phone, Link or Long text appears on the Custom fields tab but has nowhere to type in that form. Opportunities are not affected: their Custom fields tab edits every type in place. If your administrator plans a field for accounts, contacts, leads or projects, a Text field is the safe choice.
Related records
The Related tab on accounts, opportunities and projects links this record to others so the team can jump straight there. The summary reads {n} linked.
- Select Link a record.
- Choose the Record type: Project, Opportunity, Account or Contract — and Support ticket when your workspace has Support.
- Type in Search and press Enter (or select the search icon). Until you search, the dialog says Search to find records to link.
- Pick the record, add a Note (optional) explaining the link, and select Link.
Each row shows the record's status and your note. Unlink removes the link, not the record. A row you cannot open reads (unavailable — may be in another tenant or removed). On a project, links that belong to the source opportunity carry the From the opportunity chip and cannot be unlinked there.
Opportunities also show Linked automatically — From this opportunity's own details. Read-only. It lists the account, the primary contact, quotes, and vendor price requests with their state (Taking prices, Closed or Prices chosen).
Attached forms
The Forms tab sends a Tansi Form to the record's owner to complete — a site safety checklist on a project, a credit application on an account, an intake questionnaire on a lead. The summary reads {n} assigned · {m} complete.
- Select Attach form. The dialog says It flows to the record's owner to complete.
- Pick the Form.
- Turn on Required and, if a manager must sign off, Requires approval.
- Set a Due date (optional) and select Attach.
The table shows Form, Required, Due (or No due date), Status — No owner / pending, Assigned, Submitted, Submitted — awaiting approval, Approved or Rejected — needs resubmission — and View (once there is a submission) and Remove.
- In view-all mode the tab asks you to Select a tenant above to view and attach forms for this record.
- This workspace isn't linked to a Forms project yet. means an administrator has to connect the workspace to Tansi Forms first.
- A record with no owner leaves the form at No owner / pending — set an owner so somebody actually receives it.
Events and campaigns panels
Contacts and leads show an Events panel listing the events they registered for — event, date, pass, registration status, and Attended once checked in. It only appears when you have the CRM Events permission and the person has registrations.
They also show a Campaigns panel: Campaign, Channel, Outcome (with the error when a send failed) and Sent. A person never included reads Never included in a campaign, followed by either {name} can receive campaigns — add them through a campaign's audience. or {name} has opted out of email and text campaigns, so campaigns will skip them., with Go to campaigns.
Sharing with the client, item by item
Opportunities and projects can open a private portal to the client. Two locks protect it. The portal itself must be on, and each item must be marked shared. Nothing is visible until both are true.
The strip above the tabs
- Client portal is on · 3 invited · 7 items shared.
- Client portal is off — nothing is visible outside your team. If items are already marked shared it adds 7 items marked shared and waiting. — they go live the moment the portal is turned on.
- On an opportunity that became a project, the strip says the portal is managed on the project and links to it, with no controls.
See what they see opens the preview; Client access opens the access dialog.
Turning the portal on
In Client access, the switch reads Portal is off or Portal is on. Turning it on asks first — Turn on client portal? — and lists every item that will become visible, or says No items are currently marked shared. It ends with Costs, stage history and internal notes are never included. Confirm with Turn on.
Inviting people
Fill in Name, Email, Role, an optional Expires date and an optional Message, then select Invite (Invitation sent.).
| Role | What they can do |
|---|---|
| Viewer | Read what is shared. |
| Contributor | Read, and also post notes, upload files, raise requests and ask for meetings. |
| Signer | Everything a contributor can do, plus see signature requests addressed to their email. |
The Invited table shows each Person, Role, Expiry (or No expiry) and Access — Invited (with not opened yet), Active (with last opened {date}), Expired or Revoked. Actions: resend the invitation (Invitation resent to {email}.), copy their personal link (Portal link copied.), revoke, and restore a revoked person. Revoking asks Revoke access? — {name} will immediately lose access to this portal — their link stops working.
Each portal link is personal and the client page says so. Invite every person who needs access, each with the least role they need. A shared mailbox invited as a Signer lets anyone reading that mailbox sign.
Marking items shared
| Where | The control |
|---|---|
| Timeline entries, notes, quotes, invoices | A chip: Internal only or Shared with client. Select it to flip. |
| New notes | A Visible to client switch beside Add note. It turns itself off after each note, so sharing is always a deliberate act. |
| Documents | A Client can see switch. Private documents and receipts can never be shared. |
| Tasks | A Client can see switch. |
| Calls logged on an opportunity | The tick The client can see this call on their portal. |
Items the client created themselves show Theirs already or theirs. If sharing a new note fails, the note is still saved, internally: Note saved, but sharing failed — use its chip to share it.
The preview
See what they see lists exactly what an invited client would get: Kind (Document, Note, Update, Task, Quote or Invoice), Item, Who and When. With nothing shared: Nothing is shared yet — a client who opened their link today would see an empty portal.
A fixed block underneath, Never shared, whatever the settings, lists stage changes (stage, probability and loss reason), costs (everything on the costs side — what the bid cost, your rates, your margins) and internal notes, and closes with There is no configuration in which a client reads what your bid cost you.
Table view on the lists, and Sheets on a record
Two different spreadsheet-style tools carry the word Table. They do different jobs.
| List Table view | A record's Table tab | |
|---|---|---|
| Where | The Table layout of the Leads, Contacts and Opportunities lists | Inside an opportunity or a project |
| Rows | One row per lead, contact or opportunity | Rows you create — a bid tracker, a risk register, meeting minutes |
| Columns | Record fields, plus custom fields | Fields you design, sheet by sheet |
| Sharing | Read-only row shares to people outside Tansi | Stays inside Tansi |
The list Table view
Edits you type in a cell save straight away. A bad paste is reported with at most three messages, and if nothing in a batch could be saved, the cells go back to what they were.
Saved tabs sit along the top. + makes a new tab from the layout you are looking at. Your own tab's menu shares it with your team or deletes it. A tab somebody else shared is marked with a trailing dot; you can rearrange it on screen, but your changes are not saved over theirs — duplicate it to your own tabs to keep a version.
Two buttons depend on permissions your administrator grants separately. Add column needs the CRM table columns permission at Edit, and Share rows and Shared links need the CRM table sharing permission at Edit. With no workspace picked, neither appears.
Add column asks for a label (up to 150 characters) and a type: Text, Number, Date, Checkbox, Choice list (options one per line), Email, Phone, Link or Long text. The column is a new custom field for every record of that type — see the warning earlier in this module.
Sharing rows
- Tick the rows to share. Share rows stays disabled until at least one is ticked.
- Enter the recipient's name (required), Email (required), an optional Title and an optional Message (up to 500 characters).
- Pick when the link expires: 7, 14, 30 or 90 days. It starts at 30.
- Untick any columns they should not see. Every offered column starts ticked; internal columns such as owner and notes are never offered.
- Confirm. The dialog then shows the link with a copy button — copy it now.
The Shared links list shows each share's recipient, its expiry date (or Expired / Revoked) and when it was last opened, with Revoke on live links. It has no copy button. If you lose a link, revoke it and share the rows again.
Revoked links stay in the list, grayed, so you can always see who was sent what.
Sheets on an opportunity or project
The record's Table tab holds any number of sheets. You can start a sheet blank or from a template (a bid tracker, subcontractor quotes, meeting minutes or a risk register), import a CSV, an Excel workbook or a link-shared Google Sheet, duplicate a sheet with or without its rows, reorder sheets, and restore a recently deleted one. Fields can be text, long text, number, currency, percent, date, single or multiple choice, checkbox, person (people from the record's workspace), web link, a read-only value taken from the opportunity, or links to the opportunity's own documents, budget lines, price sheet, submission parts, addenda and vendors.
Selecting a record link takes you to it — the Documents tab, Pricing › Budget lines, Pricing › Price sheet, the Submission tab, or that vendor's proposal. A link to something that has since been removed tells you so. The export menu always exports the sheet you are on, after saving what you have typed. On a project, the source opportunity's sheets are shown separately from the project's own.
Events — the event record
Events in the CRM run the whole cycle: registration, passes, check-in, networking, sponsors, feedback and recordings. The list's subtitle is Registration, passes and check-in for your events.
The Events list
/crm/events has three buttons — New event, Export and Spaces & calendar — and five columns: Event, Starts, Status, Registered (confirmed attendees, shown as n / capacity when a capacity is set) and Revenue. The export adds Capacity as its own column.
The event record
Header buttons are View public page, Check-in, Edit, Publish and a More actions menu holding Close sales, Duplicate, Cancel event… and Delete. Edit, Publish and the whole menu are disabled without edit rights.
Cancel event warns Cancel this event? Every attendee is emailed and every payment is refunded automatically. This can't be undone. It is the right action for an event that has sold tickets and will not happen.
Delete is only available for an event with no orders at all — Only events with no orders can be deleted. Once somebody has bought a pass, cancelling is your only route.
The tabs are Overview, Agenda, Passes & promo codes, Registrations, Orders and Feedback, with Networking and Sponsors appearing when your workspace has those features enabled.
Which header buttons you see depends on the status. View public page and Check-in appear only on a published or closed event. Publish appears on a draft or a closed event. Close sales lives in More actions and works only on a published event. Cancel event… is unavailable once an event is canceled or completed. The record also opens on a given tab from the address bar with ?tab= and one of overview, agenda, passes, registrations, orders, feedback, networking or sponsors.
Overview
Stat tiles for Registered (out of capacity), Checked in, Net revenue and Waitlist; the Public registration page link with a Copy link button; and a list headed These orders need your attention:
Registered counts confirmed attendees only, with a progress bar when the event has a capacity. Checked in is out of the confirmed count. Net revenue adds paid and partly refunded orders, minus refunds. The public link box appears only once the event is published.
The agenda
The Agenda tab lists sessions with Time, Session, Space (the booked space, or the old free-text room), Track, Delivery and Recording. You can Add session, edit, delete and export.
The session dialog takes a title and description, start and end date and time, room, track and delivery. How people join online offers Not set yet, Tansi Meet room, Webinar or Other link (https). The Space picker shows a conflict list and a Book anyway button. A Recording link (optional) field takes a YouTube, Vimeo or other https link, used when the session has no Tansi recording.
Passes, promo codes, registrations and orders
Passes
The Passes table shows Name, Price (or Free), Sold, Visibility and Sales window, with Sold shown as sold / quantity for limited passes; the export adds Quantity as its own column. The pass dialog takes a name, description, price (0 makes it free), quantity (empty means no limit), a maximum per order, a visibility setting, sales start and end date and time, and Sessions included — leave that empty to include every session.
| Visibility | Who can buy it |
|---|---|
| Public | Anyone on the registration page. |
| Hidden — staff only | Nobody on the public page. You add these attendees yourself. |
| Code only — unlocked by a promo code | Invisible until a visitor enters a promo code configured to unlock it. |
The empty state is a reminder about sequence: No passes yet. Add one before publishing.
The pass dialog also has a Badge colour — Set colour to choose one, Use the default colour to clear it — which colors the band on printed badges unless the attendee's type sets its own. A sales start with no time opens at midnight, and a sales end with no time closes at 23:59, in the event's time zone. Max per order starts at 10, and a paid price must be at least $0.50.
Promo codes
The table shows Code, Discount, Used (as used / max when capped), Valid until and Unlocks code-only passes. The dialog takes the code, a discount type of Percent off or Amount off (per order), the amount, a maximum number of uses, valid-from and valid-until dates, which passes it Applies to (empty means every pass) and whether it Unlocks code-only passes.
Codes are stored in capitals, so spring25 becomes SPRING25 when you leave the field, and each code must be unique within the event. Valid from and Valid until are whole days in the event's time zone — the code works from the start of the first day to the end of the last. On the public page, visitors get ten tries every ten minutes, and a link ending in ?code= and your code applies it automatically.
Registrations
Search by name, email or organization; filter by status; and use Add attendee, Import and Export. The columns are Name, Email, Organization, Pass, Status, Checked in, Badge printed and CRM. The export adds Source, Order total and Ticket code. The status chips are All, Confirmed, Waitlisted, Awaiting payment and Cancelled.
Three flags tell you where to look first: Duplicate email, Needs review, and Not yet on the CRM — retrying automatically, which means the CRM link is in progress rather than broken.
Add attendee requires a first name, a last name and an email, then takes phone, organization, pass and source, with switches for Email their ticket and Allow over capacity. Import takes a .csv or .xlsx file, offers a Download template, assigns a pass, can email tickets, and reports how many rows were found, added and skipped with the errors per row.
Row actions, and the ones that bite
| Action | What it does |
|---|---|
| Check in / Undo check-in | Marks arrival without opening the check-in page. |
| Open in CRM | Jumps to the matching CRM record. |
| Resend ticket | Emails the ticket again. |
| Transfer… | Moves the registration to another person. The dialog warns that the current ticket's QR code will stop working. |
| Offer a spot | Used on a waitlisted person. When the event is full the dialog asks whether to go over capacity. |
| Reissue portal link | Emails a new personal portal link. The old link stops working immediately. |
| Networking type… | Sets the attendee's networking category. |
| Cancel registration… | Takes a reason and offers to refund their share of the order. |
When the order has not been paid, the dialog warns This order is unpaid — cancelling cancels all {n} registrations on it. On a paid order you can cancel one person and refund their share. On an unpaid one you cannot.
Orders
The Orders tab lists Order, Buyer, Attendees, Total, Refunded, Status and Placed, with a Needs review flag and an Export. One order can carry several registrations, which is why the cancellation rules above are worded the way they are.
Networking and sponsors
Two optional tabs appear on the event record when your workspace has the features enabled: Networking and Sponsors. Both also need the matching capability, and both disappear quietly if a permission check fails, which is worth remembering before you conclude they were never there.
Matchmaking settings
Below the stat cards, a settings card holds: enable B2B matchmaking, Allow virtual meetings (Tansi Meet), the maximum meetings per attendee, when requests open and close, and the default meeting length. The page reminds you that Times are in the event's time zone and names it.
Stats above the sub-tabs count requests, accepted requests with a percentage, meetings held, no-shows, the average rating and the top decline reasons.
The four sub-tabs
| Sub-tab | What you do there |
|---|---|
| Attendee types | Name and describe each type, decide whether staff approve profiles before they appear in the directory, and fill in the May send meeting requests to matrix — tick both sides for two-way requests. Below it, map each pass to an attendee type. |
| Slots & tables | Generate slots from a date, a first start time, a length, a number of slots, a break and a label. Add tables: in-person meetings take the first free table in their slot, and without tables attendees meet at the networking area. |
| Approvals | The queue of attendee profiles waiting for review, with Approve and Reject. A rejection reason is emailed to the attendee, so write it for them to read. |
| Meetings | A grid of When, Requested by, With, Status, Mode, Table, Rating with schedule, set-table, no-show and cancel actions, and an export. |
Attendees get the attendee type of the pass they hold. Changing that mapping clears the networking profiles of everybody holding that pass, and the dialog asks Continue? before it does. Set the mapping before people start filling in profiles, not after.
Sponsors and exhibitors
The Sponsors tab opens with an Exhibitor lead scanning switch — Let booth reps scan attendee badges — and stats for sponsors committed, committed value, paid, and leads scanned with the percentage who shared contact details.
Sponsorship packages lists Package, Price, Sold, Includes. The package dialog takes a name, description, price, how many can be sold, benefits one per line, how many booth reps get a lead scanner, how many complimentary passes are included and which pass they use, the logo size on the event page (Large, Medium, Small or Name only) and a display order. The tip on the comp-pass field is practical: create a hidden $0 pass such as Sponsor comp.
The Sponsors & exhibitors grid shows Sponsor, CRM account, Package, Status (Prospect / Committed / Paid / Cancelled), Amount, Paid, Comp passes, Booth reps, Leads, CRM deal. Adding a sponsor picks a package, a CRM account and a contact, and then either creates an opportunity and a draft quote from the package, or links an existing open opportunity on that account. Editing one sets the public name, website, short description, booth, the Agreed amount — which is marked paid when the opportunity's paid invoices reach it — whether the sponsor shows on the event page, and a logo up to 5 MB.
The packages table also shows each package's Logo on the event page size. The sponsors grid includes a Package column and a Manage button that opens the sponsor's panel: its CRM deal and status buttons, complimentary pass holders, booth reps and leads. The edit dialog also sets the Contact, a Display order and the Lead qualifying questions booth reps answer.
Badge scanning and consent
During registration each attendee is asked whether this event's exhibitors and sponsors may see their email and phone. Without that consent, exhibitors see only the name and the organization.
The choice is per attendee, it applies to that person's own ticket, and it can be changed at any time in the attendee portal. Withdrawing consent hides the contact details from leads that were already scanned — the scanner re-reads its leads and fails closed if that read does not succeed.
Sharing contact details is not consent to receive marketing email. The scanner banner says so, and the lead exports repeat it, referring to Canada's anti-spam law.
Check-in, badges, spaces and calendar
Check-in
/crm/events/{id}/check-in is a phone-first, staff-only page. A counter reads {n} of {m} checked in. A selector switches between a single Session and the Whole event. You can Scan tickets with camera, type a Ticket code and select Check in, Find by name, email or organization, or Register a walk-up.
When the camera will not start, the fallback is explicit: Couldn't start the camera. Allow camera access, or type the code below.
The result messages are written to be read at arm's length across a desk:
- Welcome, {name} — they are in.
- Already checked in: {name} at {time} by {who} — somebody on your team already did this.
- This ticket is for a different event.
- {name} is not confirmed (cancelled, refunded or unpaid).
- {name}'s pass doesn't include this session — the pass is real, the session is not on it.
- Ticket not found.
Check-in needs edit access to Events. Without it the page says You need edit access to Events to check people in. — worth sorting out the day before, not at the door.
Printing badges
The Print badges dialog offers three stocks: Avery 5392 (4 × 3 in, six per sheet, pocket inserts), Avery 5395 (3⅜ × 2⅓ in, eight per sheet, adhesive name tags) and 4 × 6 in, one per page for badge printers. Filter by passes, attendee types and check-in state (everyone, checked in, or not checked in yet), limit to badges not printed yet, and order by last name or by pass then name. A live count and a preview update as you filter, then Generate PDF.
Band colors come from each attendee type first, then each pass — you set them in the Networking and Passes tabs, not in the badge dialog.
The small Avery 5395 stock has no room for a QR code, so the ticket code prints instead. If you plan to scan badges at session doors, do not choose that stock.
The PDF has a hard limit per file. When your filter matches more badges than that, the dialog tells you the limit — split the run by pass or by last name.
One more hint from the dialog that saves a reprint: Print at 100 % (Actual size) — not ‘Fit to page’.
Spaces and calendar
/crm/events/spaces is subtitled The rooms and areas you book across your events, and has two tabs.
Calendar shows a day or week grid in a chosen time zone with Today, Previous and Next, one row per space, and a legend reading Draft event, Space hold and Overlaps another booking; inactive spaces carry an Inactive chip by their name. The export covers event, space, session or hold, start, end, overlap and status. A booking in an event you cannot open shows only Booked, with no name and no link (the session dialog's conflict list words it Booked (an event you can't open)) — the time is blocked, the detail is not yours to see.
Spaces is a grid of Name, Venue, Capacity, Time zone, Upcoming bookings, Active, with add, edit and delete. Capacity is marked For reference only — registrations aren't limited by it.
The dialog says it on the Available for new bookings switch: Turn this off instead of deleting a space that still has bookings. Deactivating keeps the history and stops the space being offered on new sessions.
Spaces are shared across events, so an overlap is possible and sometimes correct. The session's space picker shows the conflicts and offers Book anyway rather than blocking you. Use a Space hold — with a label such as Setup or Teardown, a start and end, and notes — to book a room for something that is not a session.
Day view runs from 07:00 to 23:00, with overlapping bookings stacked; week view runs Monday to Sunday. The time zone starts on your first active space's zone. Select a booking to open that event's Agenda tab. Holds carry a (Hold) mark, and bookings of draft, closed or completed events carry the status in brackets. On the Spaces tab, deleting a space with bookings that have not ended is refused with This space has upcoming bookings. Deactivate it instead. and a Deactivate button right in the message. Space names must be unique, and a new space's time zone can be left on Same as your latest event. Holds themselves are added on each event's Agenda tab.
What your attendees see
Six public pages carry an attendee from first sight of the event to the recordings afterward. All of them are branded, all of them offer a language switcher, and a link from an email can set the language before the page opens.
The event page and registration
/events/{slug} shows the event name, dates and venue, with Add to calendar, the Agenda, and the Passes with prices or Free, an Only {n} left warning where stock is low, and a quantity picker. A Promo code box confirms Code applied. When the event is sold out the page offers Join the waitlist; when registration has closed it says Registration is closed. A sponsor wall shows logos and names by tier.
/events/{slug}/register collects Your details (full name, email, optional phone), then one block per attendee headed Attendee {n} — {pass} with a Same as above shortcut, first name, last name, email and organization. Your custom registration questions follow, then an order summary showing subtotal, discount, tax and total with the note Final price is confirmed at checkout. The marketing opt-in and the exhibitor-sharing consent box appear here if configured. A honeypot field drops bots.
/events/{slug}/confirmed says You're registered! A confirmation email is on its way to {email}. with Download ticket, Add to calendar and Manage registration. While the card payment settles it reads Finalizing your payment… and, if that takes a while, This is taking longer than usual — we'll email you as soon as it's confirmed. A waitlisted visitor sees You're on the waitlist. We'll email you if a spot opens.
Managing a registration
/events/manage/{token} is the attendee's self-service page. It shows the status, and offers Download ticket, Add to calendar, Complete payment, Open event portal, Resend portal link to attendee, Cancel, Cancel this order and Leave the waitlist.
The cancellation copy matches the case: You'll receive a refund of your share, This registration is past the refund deadline and won't be refunded, or Your spot will be released for a free ticket. Cancelling the order warns that it cancels everyone on it.
The buyer sees Open event portal only on their own registration. For the other people on the order the button is Resend portal link to attendee, which emails the link to that attendee's own address, at most three times an hour. On an unpaid order there is a single Cancel this order (or Leave the waitlist) for everyone, and no cancel button appears once the event has started.
The attendee portal
/events/portal/{token} is the attendee's own page, greeting them by name and warning This page is your personal link. Don't share it. It has up to eight tabs; each appears only when it applies.
| Tab | What the attendee does there |
|---|---|
| Ticket | Their pass, ticket code and QR code — Show this QR code at check-in — with Download ticket (PDF) and Add to calendar. |
| Agenda | The sessions, with Join links for online ones. |
| My meetings | Requests for them, upcoming meetings, ones waiting for a response, and past meetings, with Accept, Decline (with a reason), Propose another time, Cancel meeting, a table assignment or Meet at the networking area, Join online, and a post-meeting rating. |
| Directory | Search and filter other attendees, and Request meeting with a slot picker and a choice of in person or online. |
| Exhibitors | The sponsor wall, and their own sharing consent switch. |
| Profile | Their networking profile, with Show my profile in the attendee directory and an approval state. |
| Feedback | The post-event survey. |
| Recordings | An inline player plus external watch links. |
The directory blocks requests with a reason rather than a dead button: Complete your profile to request meetings, or Meeting requests are closed. The profile tab reassures them that Your email and phone are never shown, and shows where their profile stands — not submitted, waiting for approval, approved, or needing changes with the organizer's reason.
Tabs appear only when they apply: Agenda and Profile need a confirmed registration, Feedback and Recordings appear only after the event ends, Exhibitors needs the sponsors feature, and My meetings and Directory need a pass mapped to an attendee type. In the directory only approved, opted-in attendees of types you may request appear, and the Request dialog offers Online (Tansi Meet) only when virtual meetings are allowed. Ratings ask for stars, Will you follow up? and an optional comment, once per meeting.
Decline opens Decline this request? with one Reason to pick: Not relevant to my business (the default), No availability at that time, We're already connected or Other. These feed the Top decline reasons on your Networking tab. Accepting a meeting automatically declines any other requests either person has in the same slot, and a meeting can be canceled until its slot starts.
The Exhibitors tab holds the attendee's sharing choice under Sharing with exhibitors — Share my contact details with this event's exhibitors and sponsors (they can scan my badge or find me by name) — confirmed with Your choice was saved. Below it, Exhibitors who scanned your badge lists every exhibitor that has them as a lead, or No exhibitor has scanned your badge yet. When badge scanning is off it says Badge scanning isn't used at this event.
Feedback
Back on the staff side, the Feedback tab holds the survey settings: whether to send a survey after the event, whether to ask for an overall rating out of five, whether to ask how likely they are to recommend the event out of ten, who to send it to (Checked-in attendees or Everyone with a confirmed registration) and how many hours after the event to send it, from 0 to 72. The email also links to shared recordings.
The results show the response count and rate, the average rating and the Net Promoter Score — explained on the page as the percentage of promoters scoring 9 or 10 minus the percentage of detractors scoring 0 to 6 — plus a breakdown by question and a responses grid you can export. Remove response moderates one out: It will no longer count in the results, and its CRM note will be removed.
Recordings
The Agenda tab's Recording column carries a Shared switch per session and a Publish recordings as a course action. Attendees can change their feedback answers until a stated date, and a recording still being prepared shows Processing…
Learners see nothing until you publish the course in the course builder. The course belongs to the event's workspace, so the builder only opens from that workspace. Meeting recordings and links that are not YouTube or Vimeo are skipped.
Building an event from scratch
An event in Tansi is anything people sign up to attend: a trade show, a staff training day, a site safety orientation, a fundraising gala, a community clinic. The same record handles a free lunch-and-learn for twelve and a paid conference for twelve hundred. This section walks through creating one, in the order the screens ask for things.
You need the Events permission at the edit level. With view access you can open every event but the New event and Edit buttons stay unavailable. If your account can view all workspaces, pick a workspace in the tenant picker first — New event stays disabled until you do.
The event dialog
Go to Sales & Clients › Events and select New event. The same dialog opens later from Edit on the record.
| Field | What to know |
|---|---|
| Event name | Required, up to 200 characters. Shown on the public page, tickets and badges. |
| Short description | Up to 500 characters. Shown on the public event page as the event's description. |
| Start date, Start time, End date, End time | Required. A new event starts 30 days from today, 9:00 to 17:00. The end must be after the start. |
| Time zone | Every time on the event — sessions, sales windows, promo dates, slots — is entered and shown in this zone. The list offers the Canadian zones from St. John's to Whitehorse. New events default to Edmonton. |
| Format | In person, Virtual or Hybrid. Choosing Virtual hides the venue fields and clears them when you save. |
| Venue name, Address, Unit / suite, City, Province, Postal code | Shown on the public page and in calendar invites. |
| Capacity | The most confirmed attendees the event takes. Leave it empty for no limit. Must be at least 1 when set. |
| Tax rate (%) | 0 to 100. Added to paid orders at checkout. |
| Refund cutoff (hours) | How long before the start attendees can still cancel for a refund. 0 means right up to the start. New events use 48. |
| Offer a waitlist when sold out | When on, a sold-out event offers Join the waitlist instead of closing the door. |
| Marketing opt-in text | If you type a sentence here, the registration form shows it as an unticked box. Leave it empty and no box appears. |
Under the fields sits Registration questions. Select Add question, type the Question, pick an Answer type — Short text, Paragraph, Choose one or Checkbox — and tick Required if it is. Choose one adds a Choices (comma-separated) box. Every attendee on an order answers the questions separately, so ask about the person, not the order.
Each question keeps a permanent identity behind the scenes. If you fix a typo in a question after people have answered it, their answers stay attached. Deleting the question is different — its answers no longer show.
Before you publish
- Add at least one pass on Passes & promo codes. Publishing without one is refused with Add at least one pass before publishing.
- Check the start is still in the future. A past start is refused with The event start is in the past.
- Add sessions on Agenda if people need to see a program or you will check in per session.
- Decide on the refund cutoff now. Attendees see its effect the moment they try to cancel.
Select Publish. Tansi confirms Event published. The record then shows View public page and Check-in, and the Overview tab shows the Public registration page link with Copy link.
Statuses, and what each one allows
| Status | What it means | How you get there |
|---|---|---|
| Draft | Being built. The public page answers Event not found. | Every new or duplicated event starts here. |
| Published | Open for registration. | Publish from Draft or from Sales closed. |
| Sales closed | No new registrations. Existing tickets stay valid and check-in still works. | More actions › Close sales on a published event. |
| Completed | The event is over. | Set by Tansi, not by a button. |
| Cancelled | Called off. Attendees are emailed and paid orders refunded. | More actions › Cancel event… |
Publish is offered again on a closed event, which is how you reopen sales after closing them by mistake or after adding seats.
Editing a published event
You can change a published event at any time. If you change its start, its end or its venue, Tansi sends every confirmed attendee an updated calendar invite and tells you so with Attendees were sent the updated details. Changing the name or the description does not send anything.
Moving a published event by fifteen minutes still sends every confirmed attendee a new invite. Make schedule changes in one sitting, not one field at a time across a week.
Duplicating last year's event
More actions › Duplicate copies the event, its sessions and its passes into a new Draft named after the original with (copy) on the end, and opens it. Promo codes, registrations and orders are not copied. Change the name and the dates before you publish the copy.
Agenda sessions, space bookings and holds
The Agenda tab has two halves. The top lists the sessions people attend. The bottom, Space holds, reserves rooms for things that are not sessions — setup, teardown, a vendor delivery, a rehearsal.
The sessions table
| Column | What it shows |
|---|---|
| Time | The session's start and end in the event's time zone. |
| Session | The title. |
| Space | The booked space. An older session with no space shows the free-text room instead. A warning icon appears when the session's capacity is more than the space holds. |
| Track | Your grouping, such as Main stage or Workshops. |
| Delivery | In person, Virtual or Hybrid. |
| Recording | Where the recording comes from and a Shared switch. See the after-the-event section. |
Buttons above the table: Export, Add session and, for people who also manage courses, Publish recordings as a course. Edit and delete icons sit on each row; delete asks Delete this session?
Adding a session
- Select Add session. The times start on the event's first day.
- Type the Session title (required, up to 200 characters) and a Description.
- Set the Start date, Start time, End date and End time.
- Pick a Space, or leave No space. The picker appears once your workspace has spaces; without any, a Room text box appears instead.
- Fill in Track and choose the Delivery.
- For Virtual or Hybrid, choose How people join online: Not set yet, Tansi Meet room, Webinar or Other link (https). The Meet and Webinar lists show the event workspace's meetings and webinars that have not ended.
- Optionally paste a Recording link (optional) — a YouTube, Vimeo or other https link used when the session has no Tansi recording.
- Select Save.
Errors appear inside the dialog: Pick only one way to join: Tansi Meet, a webinar, or a link., The join link must start with https://., or That meeting or webinar isn't available for this event.
When the room is already booked
Spaces are shared by every event in the workspace. If the space you picked is booked at an overlapping time, nothing is saved. Instead the dialog lists the clashes under This space is already booked at that time: — each with the event, the session, the space and the time — and adds Shared spaces can overlap. Book anyway only if that's intended. A clash in an event you are not allowed to open reads Booked (an event you can't open).
You now have two choices. Change the space or the time and select Save again, or select Book anyway to keep the overlap. Book anyway only appears while the space and times are the ones that produced the list; touch either and you are back to Save.
A large hall split by a divider, or a lobby used for registration and coffee at the same time, can carry two bookings on purpose. That is what Book anyway is for. Everything else is a real double-booking.
Space holds
A hold reserves a space for something that is not a session, so other events see the room as taken. Add hold is available once the workspace has at least one active space.
- On Agenda, scroll to Space holds and select Add hold.
- Choose the Space.
- Type a Label, or select the Setup or Teardown chip to fill it.
- Adjust the times. A new hold starts as the two hours before the event begins. Times are in the event's time zone.
- Add Notes (optional), such as who has the keys, and select Save.
Holds clash-check exactly like sessions, with the same Book anyway choice. The holds table shows Space, Label, Time and Notes and has its own Export. Deleting asks Delete the hold "{label}"?
A worked example
A general contractor runs a half-day site safety orientation for new hires every month in the training room at its yard office. The coordinator duplicates last month's event, changes the date, and opens Agenda. The two sessions — Fall protection and Equipment walk-around — keep their space. Saving the first one shows a clash: the estimating team booked the same room for a bid review. That booking belongs to another team's event, so she leaves it alone and moves the orientation's first session to the boardroom instead. It saves cleanly. She then adds a Setup hold on the training room for the hour before so the projector and harness samples can go in.
Working the attendee list
The Registrations tab is the attendee list. Each row is one person on one ticket. Several rows can share an order — a manager buying three passes for her team makes one order and three registrations.
Finding people
Type in Search name, email or organization, or select a status chip: All, Confirmed, Waitlisted, Awaiting payment or Cancelled. There is no chip for Refunded; refunded people appear under All.
| Column | What it tells you |
|---|---|
| Name | With a Duplicate email chip when another registration uses the same address, and a Needs review chip when the order is flagged. |
| Email, Organization, Pass | As entered. |
| Status | Awaiting payment, Confirmed, Waitlisted, Cancelled or Refunded. |
| Checked in | The time they were checked in, or a Check in button for a confirmed person who has not arrived. |
| Badge printed | When their badge was last printed, or a dash. |
| CRM | A link to the matching contact or lead. A warning icon means Not yet on the CRM — retrying automatically. |
Export adds three columns the screen leaves out: Source (Online, Staff added, Imported or Walk-up), Order total and Ticket code. It exports what your search and chip currently show.
Each row also has a badge icon that prints that person's badge. It works with view-only access too, so a volunteer can reprint a lost badge without edit rights.
Adding one person
Add attendee requires First name, Last name and Email; Phone and Organization are optional. The Pass list includes every pass, with its visibility in brackets, so this is how hidden passes such as speaker or crew passes get used. Source is Staff added or Walk-up. Email their ticket is on by default; Allow over capacity is off. People you add are not charged.
Importing a list
- Select Import, then Download template if you need the column layout: FirstName, LastName, Email, Phone, Organization.
- Select Spreadsheet (.csv or .xlsx) and pick your file. Tansi shows how many rows it found.
- Choose the one Pass every row will get.
- Decide on Email tickets. It is off by default here — the opposite of Add attendee.
- Select Import. The result reads {n} added · {n} skipped, with a Rows not imported list such as Row 4: missing name or invalid email or Row 9: pat@example.com is already registered.
People already confirmed for this event, by email, are skipped rather than duplicated. Split the file and import twice if different groups need different passes.
The row menu
The menu at the end of each row needs edit access to Events. Actions that do not apply to a row are grayed out rather than hidden.
| Action | Available when | What happens |
|---|---|---|
| Resend ticket | Confirmed only. | Emails the ticket again. |
| Transfer… | Always. | Moves the ticket to a new name and email. The old QR code stops working, the attendee gets a new portal link, their networking profile is cleared, and any open meetings are canceled with the other person emailed. |
| Reissue portal link | Not on Cancelled or Refunded rows. | Emails a new portal link; the old one stops working. |
| Networking type… | With the networking permission. | Overrides the attendee type that comes from the pass. |
| Offer a spot | Waitlisted only. | Free pass: confirmed at once, ticket sent. Paid pass: moved to Awaiting payment with a 48-hour hold and a payment link by email. |
| Undo check-in | Checked in only. | Clears the arrival time. |
| Cancel registration… | Not on Cancelled or Refunded rows. | Cancels, with an optional reason and refund. |
If the event is full when you offer a spot, Tansi asks The event is full — Offer the spot anyway and go over capacity? Choose Offer anyway or Keep it.
Canceling, and the refund tick
The cancel dialog changes with the order. On a paid order there is a tick, Refund their share of the order, which starts unticked — leave it unticked and the person is canceled with no money returned. Staff refunds ignore the refund cutoff. On an unpaid order the dialog warns This order is unpaid — cancelling cancels all {n} registrations on it. If a refund fails you see The refund could not be processed. Try again or refund in Stripe.
The refund tick is off by default on purpose — some cancellations are not refundable. If you promised a refund, tick it before you confirm. There is no separate refund button afterward.
Order statuses
| Status | Meaning |
|---|---|
| Pending | Waiting for payment. A seat is held until the hold expires; then the order becomes Expired and its registrations Cancelled. Waitlist orders are Pending without a hold and are not expired. |
| Paid | Paid in full. |
| Free | No payment needed. |
| Partly refunded | Some registrations were refunded. |
| Refunded | Fully refunded. |
| Cancelled | Canceled without payment. |
| Expired | The payment hold ran out. |
Running the door on event day
The check-in page is built for a phone or tablet held at a registration desk. Open it from Check-in on a published or closed event. It needs edit access to Events; volunteers with view access see You need edit access to Events to check people in. Sort access out the day before.
Setting up a station
- Sign in on each device and open the event's Check-in page.
- If the event has sessions, set Session to Whole event at the main door, or to one session at a breakout room door.
- Select Scan tickets with camera and allow camera access when the browser asks.
- Do a test scan with a staff ticket, then Undo check-in it from the Registrations tab.
- Turn the device volume up — a success has its own beep.
Three ways to check someone in
- Scan the QR code from their ticket email, PDF or portal.
- Type the Ticket code and select Check in. Use this when the camera will not start: Couldn't start the camera. Allow camera access, or type the code below.
- Type at least two letters in Find by name, email or organization and select Check in beside the right person. People already in show a Checked in chip.
Holding the same code in front of the camera does not check someone in twice: a repeat of the same code within three seconds is ignored. If you scan a second ticket while the first is still being checked, the page says Still checking the previous ticket… and ignores it — scan it again.
Reading the result
| Banner | What to do |
|---|---|
| Welcome, {name} (green) | Let them in. Their pass name shows underneath. |
| Already checked in: {name} + at {time} by {who} (amber) | Someone used this ticket already. Ask for ID before letting a second person in on it. |
| This ticket is for a different event | No details are shown, even for your own workspace's events. Point them to the right door. |
| {name} is not confirmed (cancelled, refunded or unpaid) | Send them to the desk to sort out payment or registration. |
| {name}'s pass doesn't include this session | Their ticket is real but this session is not on their pass. |
| Ticket not found | Check the code, or search by name. |
Checking someone into a session also checks them into the event. The counter at the top reads {n} of {m} checked in for whichever you selected.
Walk-ups
Register a walk-up opens the add attendee dialog with the source set to Walk-up. When you select Add, Tansi checks the person in straight away — into the selected session too. Walk-ups are not charged, so take any payment separately according to your own process.
Badges at the desk
After a welcome or already-checked-in result, a Print badge button prints that person's badge on the stock you last used. If nothing opens, the browser blocked the pop-up: Your browser blocked the PDF. Allow pop-ups for Tansi and try again.
For a run of badges before the doors open, use Print badges on the Registrations tab. Choose the stock, narrow by Passes, Attendee types (shown when the event has them) and Check-in, tick Only badges not printed yet, choose the Order, and watch the live count — {n} badge(s) will print. One PDF holds up to 2,000 badges. Confirmed attendees print, and so do unpaid ones still holding a seat. Printing stamps Badge printed on exactly the badges in the PDF, so the next run with Only badges not printed yet picks up only latecomers. Tansi remembers your stock choice on that browser.
At a regional trade show, one tablet per door scans tickets and a laptop at the help desk runs search and walk-ups with the badge printer attached. The volunteers at the doors never need to type anything.
Setting up matchmaking, step by step
Matchmaking lets attendees request short one-to-one meetings with each other — buyers with suppliers, investors with founders, job seekers with employers. It lives on the Networking tab, which appears when you have the networking permission. Changing anything there needs that permission at the edit level.
The order of setup matters, because one step clears work done in another. Follow it top to bottom.
1. Create attendee types
On Attendee types, select Add attendee type.
| Field | What it does |
|---|---|
| Name | Required, up to 100 characters, such as Buyer or Supplier. |
| Description | Up to 300 characters, for your team. |
| Staff approve profiles before they appear in the directory | When ticked, a profile waits in Approvals before others can see it. When not, it goes live on save. |
| Badge colour | The band color on printed badges for this type. It wins over the pass color. |
| May send meeting requests to | One tick per existing type. Tick both sides for two-way requests. A brand-new type cannot tick itself until it has been saved once. |
| Profile questions | What attendees of this type fill in. Tick Show in directory on the answers others may see; the rest are for organizers only. |
Deleting a type that a pass or attendee still uses is refused: Passes or attendees still use this type.
2. Map passes to types — before anyone fills in a profile
Under Pass → attendee type, choose a type for each pass, or No networking. Attendees get the type of the pass they hold. Setting a first mapping saves straight away. Changing an existing mapping asks Changing this pass's attendee type clears the networking profiles of everyone holding it. Continue? and clears them if you choose Change.
3. Settings
In Matchmaking settings, switch on Enable B2B matchmaking for this event and, if wanted, Allow virtual meetings (Tansi Meet). Set Max meetings per attendee (empty means no limit), the Default meeting length (minutes) (5 to 240, starting at 20), and when Requests open and Requests close. An empty close date means until the event starts. Select Save; nothing on this card saves until you do.
4. Slots and tables
On Slots & tables, select Generate slots. Give a Date, when the First slot starts at, the Length (minutes) (5 to 240), the Number of slots (1 to 100), a Break between slots (minutes) (0 to 120) and an optional Label. Tansi reports {n} slot(s) added. Generating again adds more; an identical slot is skipped, but any overlap with existing slots, or a slot outside the event, rejects the whole grid.
Labels can be edited in the table. A slot with meetings cannot be deleted until they are canceled. Add Tables by name: in-person meetings take the first free table in their slot, and without tables attendees are told to meet at the networking area. A table with upcoming meetings cannot be deleted.
5. Approvals
Approvals ({n}) lists profiles waiting for review, with every answer and a Public chip on the ones shown in the directory. Approve emails the attendee. Reject asks for a Reason (sent to the attendee) of up to 300 characters; they see it in their portal as Needs changes: {reason}. If the attendee edits their profile while you are reviewing it, your action is refused — reload and review the new version.
6. The meetings grid on the day
Meetings lists every meeting with When, Requested by, With, Status (with the decline reason underneath), Mode, Table and Rating. Filter by type and by status: Requested, Accepted, Declined, Cancelled, Held, No-show, Expired.
| Row action | When it shows |
|---|---|
| Set table | Accepted, in-person meetings. Both attendees are emailed. |
| {name} didn't attend / Neither attended | Accepted or held meetings whose slot has started. |
| Cancel meeting | Requested or accepted. Both attendees are emailed. |
Schedule a meeting books two confirmed attendees directly: pick the Attendee, who they Meets with, a future Slot, the mode and an optional table. Staff scheduling ignores request rules, windows and limits, but never double-books anyone.
Accepted, held and no-show meetings are logged as activities on each person's linked contact or lead in the CRM, and ratings are added to them.
Networking type… on a registration always opens showing Use the pass type, even when the person already has an override. Saving without choosing removes their override and, if the type changes, clears their profile. Pick the type you want every time.
Selling and managing sponsorships
The Sponsors tab appears when you have the sponsors permission. It ties every sponsorship to a real CRM deal: the quote, the signature and the invoice happen on the opportunity, and the sponsor's status follows them.
Packages first
Add sponsor stays disabled until at least one package exists. Select Add package:
| Field | What to know |
|---|---|
| Name, Description | Name is required (150 characters), such as Gold or Exhibitor booth. |
| Price | Used for the draft quote. |
| How many can be sold | Empty means unlimited. A sold-out package shows as {name} — sold out and cannot be picked. |
| Benefits (one per line) | Listed under the package name in the table and on the quote. |
| Booth reps with a lead scanner | 0 to 50 scanner links per sponsor. |
| Complimentary passes | 0 to 200 free tickets per sponsor. |
| Pass used for complimentary passes | Which pass those tickets use. Available once Complimentary passes is above 0. Tip: create a Hidden $0 pass such as "Sponsor comp". |
| Logo on the event page | Large, Medium (the default), Small or Name only. |
| Display order | Sorts packages on the event page. |
Adding a sponsor
- Select Add sponsor and pick the Package.
- Type at least two letters of the company in CRM account and pick it. The account must already exist in the event's workspace.
- Pick a Contact, or No contact.
- Choose Create an opportunity and a draft quote from the package, or Link an open opportunity of this account and pick it. Opportunities already converted to a project or already used by another sponsorship of this event are not offered.
- Select Save. Tansi says Sponsor added. Send the quote from the opportunity.
If the deal could not be created — most often because the pipeline has no open stage — you see Sponsor added, but the CRM deal couldn't be created. Open the sponsor to retry. The sponsor exists; select Manage and then Create CRM deal once the cause is fixed. An account can hold only one live sponsorship per event.
The sponsors table
Columns: Sponsor (logo, name and booth), CRM account, Package, Status, Amount, Paid, Comp passes and Booth reps (used out of allowed), Leads, and CRM deal — an Open opportunity link or a No CRM deal chip. Each row has Manage, which view-only users can open too, and an edit icon.
Statuses
A sponsor moves up through Prospect, Committed and Paid, and never back down on its own; Cancelled sits outside that order. Tansi re-reads each sponsor's CRM deal every time the tab opens, so the status follows the opportunity. Paid comes when the opportunity's paid invoices reach the sponsor's Agreed amount. In the Manage panel you can also set a status by hand: Mark committed, Mark paid, Cancel sponsorship or, on a Cancelled sponsor, Reinstate. A hand-set status shows Marked by staff: {status}.
The confirmation says it: Booth rep links stop working. {n} complimentary pass(es) stay valid — cancel them from the Registrations tab if needed.
Comp passes and booth reps
Both unlock once the sponsor is Committed or Paid; before that the panel says Available once the sponsorship is committed.
- Add pass holder takes a name, email, an optional organization (empty uses the sponsor's name) and Email the ticket now. The holder appears on the Registrations tab like any attendee; cancel them there.
- Add booth rep takes a name, email and Email language — English, French or Spanish. The rep is emailed a personal scanner link and needs no Tansi account. The table shows when they were invited, when they last opened the link and how many leads they scanned. Send a new link replaces the link; Remove kills it, but their leads stay with the sponsor.
Editing a sponsor
The edit icon sets the Name on the event page, Website (https://), Short description, Booth, Agreed amount, Contact, Display order, Show on the event page, the Logo (PNG, JPG or WebP up to 5 MB — a new or removed logo only sticks when you select Save) and Lead qualifying questions that booth reps answer for each lead. Those answers are always optional.
Leads, and what you see that exhibitors do not
All exhibitor leads at the bottom of the tab, and Leads inside each sponsor's panel, list every scan with Attendee, Organization, Email, Shared with exhibitor, Rating, Notes, Scanned by and Scanned. Use Refresh to pick up new scans.
The organizer's grid shows the attendee's email even when Shared with exhibitor reads Not shared. That column is the attendee's consent right now. Do not export this grid and pass it to a sponsor — it would hand them contact details the attendee chose to withhold.
The booth rep's lead scanner
Booth reps work from a link emailed to them when they are added. It opens on a phone without a Tansi account. The page greets them with Hi {name} — scanning at {event} and a privacy note: they see an attendee's email and phone only if the attendee agreed, the link is private, and sharing details is not consent to marketing email under Canada's anti-spam law.
An expired, replaced or removed link shows This scanner link isn't valid anymore. Ask the event organizer for a new one. The organizer fixes that with Send a new link.
Scanning
The Scan tab offers three ways to add a lead:
- Start camera and point it at the badge's QR code.
- Type the Ticket code and select Add lead. Use this for the small Avery 5395 badges, which print the code instead of a QR.
- Find by name — type at least three letters. Only attendees who agreed to share appear, up to five at a time: Only attendees who agreed to share their details appear here. Others: scan their badge.
Results read {name} added to your leads., {name} was already in your leads. or Ticket not found for this event. Scanning too fast gives Too many attempts. Please wait a few minutes and try again. Once scanning closes the tab says Scanning is closed for this event. You can still edit and download your leads.
Qualifying a lead
After a scan the lead card opens. It shows the name and organization, the email and phone as links only when the attendee shares them (otherwise This attendee hasn't chosen to share contact details.), a rating — Not rated, Hot, Warm or Cold — Notes up to 2,000 characters, and the sponsor's Qualifying questions. Select Save. Remove lead deletes it after Remove {name} from your leads?
The Leads tab
Leads ({n}) lists every lead the sponsor's reps captured — reps share one list. Each row shows Scanned {time} by {rep}, the rating and a Contact shared chip. Download your leads offers Excel, PDF and CSV; each file repeats the consent and anti-spam note.
Attendees can withdraw sharing at any time in their portal. The scanner re-reads consent every time, so a lead that showed an email this morning may not show it this afternoon. Downloads follow the same rule.
Example: an industrial supply company exhibiting at a construction expo gives two reps scanner links. Between conversations they rate each lead Hot, Warm or Cold and note the project the visitor mentioned. That evening the sales manager downloads the Excel file and follows up only with leads that show a shared email.
Helping attendees with links, payments and cancellations
Attendees never sign in to Tansi. Everything they do runs on two personal links: the manage link for the order, sent to the buyer, and a portal link for each attendee. Knowing which is which solves most support requests.
The manage page
The buyer's confirmation email and the confirmation page both lead to Your registration. It shows the event, Add to calendar, the order Status, and one row per attendee with their status.
| Button | When the buyer sees it |
|---|---|
| Complete payment | The order is unpaid, its seat hold has not run out, and the event has not started. |
| Cancel this order / Leave the waitlist | The order is unpaid (or entirely waitlisted) and the event has not started. It cancels everyone on the order at once. |
| Download ticket | On each confirmed attendee. |
| Open event portal | Only on the buyer's own registration — the one with the buyer's email. |
| Resend portal link to attendee | On everyone else's live registration. It emails that attendee's own address, never the buyer. |
| Cancel | On each live registration of a paid or free order, before the event starts. |
When a buyer cancels one person, the dialog states the outcome: You'll receive a refund of your share., This registration is past the refund deadline and won't be refunded., or for a free ticket Your spot will be released. After the event starts, no cancel buttons appear.
A manager who bought tickets for her team sees Resend portal link to attendee on their rows, not their portals. Each portal holds that person's meetings, profile and sharing choice, so it only ever goes to their own inbox. Resends are limited to three per attendee per hour.
What the portal shows, and when
The portal's tabs appear only when they apply. Expect fewer tabs than the full list.
| Tab | Appears when |
|---|---|
| Ticket | Always. Awaiting payment and waitlisted attendees see a message instead of a QR code. |
| Agenda | The registration is confirmed. It lists only sessions their pass includes. |
| Feedback | Confirmed, the event has ended, the survey is on and they are in its audience. |
| Recordings | Confirmed, the event has ended, and at least one recording their pass allows is shared. |
| Exhibitors | Confirmed and the sponsors feature has something to show. |
| My meetings, Directory | Their pass maps to an attendee type and matchmaking is on. |
| Profile | Confirmed and they have an attendee type. |
A link from an email can open a given tab with ?tab= — for example the follow-up email opens the Feedback tab directly.
Common requests
| The attendee says | What you do |
|---|---|
| I lost my ticket | Resend ticket on their row, or tell them the ticket is on their portal's Ticket tab. |
| My portal link doesn't work | They see This link isn't valid anymore. Ask the organizer for a new one. Use Reissue portal link; any older link stops working. |
| I came off the waitlist but can't pay | A paid offer holds the seat for 48 hours. Point them to Complete payment on the manage page before it runs out. |
| A colleague is going instead of me | Transfer… the ticket. The new person gets a new QR code and portal link. |
| I want a refund but it's past the deadline | Guests cannot get one themselves. Staff can cancel with Refund their share of the order ticked; the cutoff does not apply to staff. |
| Payment went through but the page is still spinning | The confirmation page checks for about a minute, then says This is taking longer than usual — we'll email you as soon as it's confirmed. Check the Orders tab before charging again. |
After the event: feedback, recordings and a course
Everything after the last session is configured before the event: the survey on the Feedback tab, and recording sharing on the Agenda tab. Tansi sends one follow-up email to each attendee that offers whichever applies — Share your feedback, Watch the recordings, or both. The email is a transactional message and never claims the person attended.
Survey settings
| Setting | What it does |
|---|---|
| Send a feedback survey after the event | Turns the survey on. |
| Survey questions | Your own questions, built like registration questions, up to a fixed maximum. Choose-one and checkbox questions get a bar chart in the results. |
| Ask for an overall rating (1 to 5 stars) | Adds the rating question. |
| Ask how likely they are to recommend the event (0 to 10) | Adds the Net Promoter question. |
| Send the follow-up email to | Checked-in attendees or Everyone with a confirmed registration. This also decides who may answer. |
| Hours after the event ends | 0 to 72. The email also links to shared recordings. |
Select Save survey settings. You can change settings in any event status. People with view access see the questions as a plain list.
Checked-in attendees is the honest choice when you scanned everyone at the door. If check-in was patchy, choose everyone confirmed, or people who came will never be asked.
What attendees see
The portal's Feedback tab, Tell us how it went, shows You can change your answers until {date}., the star and 0-to-10 buttons, your questions, and Send my feedback — Update my feedback once sent. After the closing date it says This survey is closed.
Reading the results
Tiles show Responses ({n} of {m} and the response rate), Average rating and Net Promoter Score — the percentage of 9s and 10s minus the percentage of 0s to 6s. Answers by question charts choice questions. The Responses grid has one column per question, Submitted showing the last edit, and Export.
Each response is also saved as a note on the attendee's CRM record. Remove response asks Remove {name}'s response? It will no longer count in the results, and its CRM note will be removed. The attendee can no longer edit a removed response.
Sharing recordings
The Agenda tab's Recording column names each session's source: No recording, Processing, Webinar recording, Meeting recording, Webinar or meeting link, or Recording link (the link typed in the session dialog). Turn on Shared per session: Recording shared with attendees. Attendees see shared recordings their pass allows on the portal's Recordings tab after the event ends — Play for Tansi files in an inline player without a download button, Watch (opens a new tab) for links.
Publishing recordings as a course
If you can also manage courses, Publish recordings as a course turns the shared recordings into a draft course in the event's workspace: one part per event day, one step per shared session in agenda order. The result dialog says A draft course was created., The draft course was updated. or, for a course already live, The course was updated — learners already see the new steps., then Steps added: {n} and what was not added:
- meeting recordings aren't supported in courses yet
- only YouTube and Vimeo links can be added
- no recording yet
- Under Added, but check: a paid webinar step, which learners must register for.
Publishing again only adds sessions that are not in the course yet; it never removes steps. Open the course builder appears when you are in the event's workspace.
Example: a regional health authority runs a free community wellness fair with talks on nutrition and fall prevention. It surveys everyone confirmed 24 hours later, shares the two talk recordings, and publishes them as a course for residents who missed the day. The same steps suit a contractor's annual safety summit or a software user group — nothing here is limited to health events.
Event playbooks
These walk-throughs string the earlier sections together. Each lists only the steps that kind of event needs.
A paid trade show with exhibitors
- Create the event with a capacity, a 13% tax rate and a 72-hour refund cutoff.
- Add passes: Early bird (public, sales end a month out), General (public), Exhibitor staff (hidden, $0), Sponsor comp (hidden, $0).
- Add a promo code that unlocks a code-only VIP pass, and share the event link with ?code= and the code on the end so it applies on arrival.
- Build sponsorship packages, add sponsors from CRM accounts, and send each quote from its opportunity.
- Switch on Let booth reps scan attendee badges so the registration form asks for sharing consent.
- Publish. Watch the Overview tile for registrations and the warning list for orders that need attention.
- Print badges on Avery 5392 the day before; print latecomers with Only badges not printed yet.
- After the show, share recordings and send the survey to checked-in attendees.
A free internal training day
- Create the event with no tax and a 0-hour refund cutoff (nothing to refund).
- Add one public $0 pass with a quantity equal to the room size.
- Import the staff list with the pass and Email tickets switched on.
- Add sessions per room and check in per session to record attendance for each module.
- Export the Registrations tab afterward for the training records.
A community health fair
This example is health-related; the same setup works for a library open house or a trades career day.
- Create a free event with a waitlist, and a capacity matching the hall.
- Add registration questions such as preferred language and accessibility needs.
- Book the hall and the two side rooms as spaces, with a Setup hold the evening before.
- When it fills, offer waitlist spots as cancellations come in.
- Use walk-up registration at the door for people who did not sign up.
A construction site safety orientation
- Duplicate last month's orientation and change the dates.
- Keep one hidden pass and add every new hire yourself with Add attendee, so nobody can sign up from the public page.
- Check people into each session — classroom, then yard walk — so the record shows who completed both.
- Publish the recording of the classroom part as a course for crews who start mid-month.
An event whose only pass is Hidden shows no passes to the public. People get in only when staff add them. That is the simplest way to run an invitation-only event.
Procurement Portals and the vendor portal
/crm/procurement-portals is a register of the tender sites you bid on. Its subtitle is The tender sites you bid on.
Finding a portal
Search portals matches the name, the address, the place, the description and the keywords at once — the placeholder gives the idea: Name, website, place or keyword — “janitorial”, “BC”, “medical”… Beside it sit Who buys there (anyone, a buyer level, or Not tagged yet), Clear, an export menu, and a layout switcher offering Tiles, Rows and Kanban, where kanban groups by who buys there.
In rows layout the columns are Portal (logo, name, host and place), Who buys there, Covers, Keywords, Sign-in (Saved or None, plus a shared-account marker) and Actions. The table caption states the rule: credentials are never shown in this table.
Adding a portal
The dialog shows an error summary reading {n} things need fixing. Name and Website are required — the website is where Go to site takes you, and it opens in a new tab so Tansi stays where it is. A logo upload requires a description, because a screen reader reads both the description and the name.
Details is three lines for what is actually posted there and anything somebody needs to know before bidding — a subscription, a registration, a set-aside. The address block is country-aware: choosing a country sets the region list and the postal code format. Search keywords are comma-separated and are what the search box above the list matches on, so put the words your team would actually type.
Saved sign-ins and the PIN
The sign-in fields store a username and password encrypted. The dialog is honest about the limits: Your PIN decides who can see it on this screen — it does not encrypt it, and it does not stop an administrator with database access. If that is not good enough for this account, leave it out and keep it in a password manager.
The PIN dialog repeats the point: four to eight digits, not your Tansi password, not what encrypts anything — it stops the person walking past your desk. Shared team logins for low-value portals are a reasonable use. Anything that touches money is not.
The view dialog is organized into What is posted there, Who buys there, Where, Search keywords, Sign-in and Reveal history. Whether a saved sign-in can be revealed at all, and whether the reveal history shows, depends on a separate permission.
The first time, Tansi asks you to Set your PIN with Confirm PIN; after that, Enter your PIN asks Remember it?:
| Choice | What it means |
|---|---|
| Just this once | You will be asked again next time. |
| Until I sign out | Anybody using this computer while you are signed in can reveal passwords without the PIN. |
| 30 days on this device | Convenient, and the loosest of the three. Not for a shared or public computer. |
In a portal's view, Copy username and Copy password put the sign-in on your clipboard — the password without ever showing it, though it still needs your PIN. Tansi cannot type this into the portal for you. Reveal history records who revealed or copied the password, and when.
In the edit dialog, tick This is a shared account when everyone signs in as the same person — so the site cannot tell who did what. Worth knowing before somebody submits a bid. Remove the saved password clears it, and Remove this portal deletes the portal after a confirmation. Without a logo, a tile shows the portal's initials in a color.
Asking vendors for prices
From an opportunity's Pricing tab you can send a vendor a price request. The vendor gets a private page at /crm/vendor-request/{token} showing the request name, your instructions, the documents you shared arranged into sections, the items to price (description, quantity, unit), any questions, and the due date. Above it sits an offer: Have other price requests from {tenant}? See them all in one place.
The vendor portal
/vendor-portal signs a vendor in without a password: Enter the email address your price requests were sent to. We'll email you a link to sign in. No password needed. The reply is careful not to confirm whether the address is known — If we know this address, we've sent a link. It works for 20 minutes.
A vendor who leaves the email until tomorrow gets That sign-in link has expired or was already used. Ask for a new one. Tell vendors to request the link when they are ready to use it, not when they first read your email.
Once in, the vendor sees Your price requests — Every price request we've sent you, by opportunity. Pick one to see the documents and send your prices. — with filters for All, Waiting for you, Prices sent and Closed, a search, and a status per request running from New · waiting for your price through Prices sent and You declined to Closed, with due and sent dates and item and document counts. Sign out is available.
Documents can require their own PIN, and which documents each vendor can see is chosen per vendor when the request is built.
Which permissions show saved sign-ins
Saved sign-ins appear only for people with the Procurement credentials permission. The Reveal history, which records who looked at a saved sign-in, appears only for people with the CRM admin permission.
The vendor's sign-in link page
When a vendor opens the emailed link, a page reads Select the button to continue. This link works once. The one use is spent only when they select Continue to your price requests, so an email scanner opening the link first does not burn it. Too many requests in a short time show Too many tries in a short time. Wait a few minutes and try again.
Pricing: the five sections and budget lines
An opportunity's Pricing tab is where a bid's numbers come from. It has five sub-tabs, always in this order, each with a status chip in words so you can see at a glance what still needs work.
| Sub-tab | What it does | Chip |
|---|---|---|
| Budget lines | The breakdown of the work: what is delivered, by whom, at what cost. | 3 to price, Not priced or Done |
| Vendor prices | Requests to suppliers and subcontractors for prices. | 2 need vendor prices, 4 prices in or Chosen |
| Price sheet | What the client sees, saved as numbered revisions; and the quotes list. | 1 to fix, Changed since Rev 2 or Rev 2 |
| Contractors | Your contractor register and who is in this budget. | |
| Bid costs | What chasing the bid costs you: expenses and staff time. | Over budget |
The first time someone who can edit opens Pricing on a live opportunity, Tansi adds the Bid costs line to the budget by itself. People who can only view never cause that write.
Projects have a Budget tab instead, with Budget, Contractors and Costs, plus the source opportunity's bid build-up shown read-only.
Reading the budget
The header carries a Table / Timeline switch, Expand all and Collapse all, Apply template, Add line, and links to Manage templates and Units of measure in CRM Settings. Filters narrow the table by Who does it, Contractor and Basis, and a summary reads 14 lines · 11 priced · 3 contractors · budget $86,400.00.
| Column | What it holds |
|---|---|
| Line | The name, indented by level, with a paperclip count of linked vendor files, a Vendor price chip on lines priced from a vendor's proposal, and a required marker. |
| Who does it | Our team, Subcontract or Supply. |
| Qty, Unit | The quantity and its unit. |
| Qty 2 (optional), Unit 2 | A second quantity, for prices such as 3 technicians × 5 days. |
| Unit cost, Line cost | Line cost is quantity × second quantity × unit cost. |
| Actions | Move out, move in, add under, and the ⋮ menu. |
You edit the lowest lines right in the table, and each change saves as you make it. Parent lines are never typed into: their cost and dates add up from the lines under them. The footer gives the total — on an opportunity labeled Direct cost (bid costs are added after overhead and contingency).
Adding and arranging lines
Add line opens Add a budget line:
| Field | Notes |
|---|---|
| Name | Up to 200 characters. Placeholder Mechanical rough-in. |
| Basis | Estimated, Budgetary, Quoted or Committed — how firm the number is. |
| Delivery | Self-perform, Subcontract or Supply. |
| Contractor | Required for a subcontract line; otherwise None — we do it. |
| Quantity, Unit, Qty 2, Unit 2 | Units come from CRM Settings. A unit no longer in the list shows as {unit} (not in the list). |
| Cost | The unit cost. A live line shows the sum, such as 40 h × 85.00 = 3,400.00. |
| Starts, Ends | Dates for the timeline. The end cannot be before the start. |
| Notes | Up to 600 characters. |
Lines go up to eight levels deep. Use the out and in buttons at the end of a row — In puts the line under the one above it — or Alt + Shift + arrow keys, the ⋮ menu (Move up, Move down, Move in a level, Move out a level, Add a line under this one, Edit details…, Delete), or drag the grip on the left. Each move is announced, for example Concrete: level 2, position 3 of 5 under Structure.
If you add a line under one that already has a price, Tansi moves that price into a new sub-line with the same name. The dialog warns you first: The line above has its own price. Only the lowest lines carry prices, so its quantity and cost move into a sub-line with the same name. Nothing is lost, but the structure changes.
Deleting asks Delete “Concrete”?, or Delete “Structure” and the 6 lines under it? — read the count. Nothing can go under a line priced by a vendor, or under the Bid costs line.
The Bid costs line
The system line Bid costs always sits last, marked From Pricing › Bid costs. Its amount comes from the Bid costs sub-tab and cannot be typed over. Its Charge to client switch decides whether those costs are part of the price (Bid costs are charged to the client.) or come off your margin (Bid costs are left out of the price.).
Templates
When the budget is empty and your workspace has a default pricing template for this opportunity type, a banner offers it: Start from the “{name}” template? with Apply or Not now. Apply template does the same at any time: Adds the template's lines that are missing. Lines you already have are left as they are, and nothing is removed. The result reads {template} applied: 12 lines added. Nothing was removed., and mentions any lines skipped because they would have gone under a priced line.
The timeline view
Timeline draws each line as a bar from its start to its end date — Set start and end dates on the left. Point at or tab to a bar to see its details. Parent lines show as roll-ups. Zoom with Weeks, Months or Quarters; Today and Bid due are marked.
On a project
A project's own lines are its working budget. The source opportunity's lines appear underneath, read-only, as the baseline, and a strip compares baseline, working budget, actual cost and the variance. The Bid costs line never shows on a project.
When two people edit the same budget at once, one of them sees Someone changed these lines at the same time. The list has been refreshed; try again.
Pricing: bid costs, contractors and the bid build-up
Bid costs
What it costs us to chase this bid: expenses plus staff time logged against it. The total is the “Bid costs” line on Budget lines. Set a Bid budget if you want a ceiling (Leave empty for no budget). The summary shows Expenses, Staff time and Left in bid budget — or Over budget by {amount}, which also lights the Over budget chip on the sub-tab.
A last line tells you where the money goes: {amount} is charged to the client through the Bid costs budget line., or {amount} is not charged to the client; it comes off the real margin.
Everything on the costs side — expenses, receipts, staff time, rates — is never shown to a client, whatever the portal settings.
The costs ledger
Four tiles: Spent on this bid, What it actually cost (after recoverable tax), Labour (12.5 hours, from logged time) and Entries (5 with a receipt, 2 without). Filter by Type and Cost centre; export as Cost to Bid.
| Column | Notes |
|---|---|
| Date, Type | Types: Labour, Subcontractor, Printing & binding, Courier & shipping, Travel, Bid security, Software & data, Other. |
| Description | With Paid to {supplier} underneath. |
| Cost centre | An expense account from your chart of accounts. |
| Amount, Tax, Total | Tax shows how much comes back, such as 6.50 back. |
| Receipt | Receipt or No receipt. |
| Menu | Edit, Attach receipt, Delete (after Delete the 120.00 cost paid to {supplier}?). |
A second table, Labour — derived from logged time, not typed in, lists time entries with their minutes and amount. Two bar charts show Where the money went (pre-tax, by type) and By cost centre (pre-tax); anything without a Cost centre is counted as Uncoded. Log time opens Log time against this deal, which also accepts the opportunity's owner and team even if they have no account rate.
Adding a cost
- Select Add a cost.
- Set the Date (today or earlier), Type, Cost centre, Paid to / supplier and Amount before tax.
- Add a Description, and tick Recoverable from the client if we win if the contract lets you claim it back.
- Under Taxes, pick a preset — No tax, GST 5%, GST + PST (BC), HST 13% (ON), HST 15% (Atlantic) or GST + QST (QC) — or Add a tax row by hand with a name, Rate % and a Recoverable tick.
- Choose a receipt or supplier invoice (PDF, PNG or JPG). It uploads when you save and is internal always.
- Select Save, or Save and add another to keep going (Cost added.).
A live line totals it for you: Net 100.00 · Tax 12.00 · Total 112.00 · Recoverable 5.00 · Actual cost 107.00. Each tax is rounded to the cent before adding up. If the receipt fails to upload, the cost is still saved and you can attach the receipt from the row menu.
Contractors
The Contractors sub-tab shows the workspace's contractor register. The switch toggles between In this budget and Whole register.
| Column | Notes |
|---|---|
| Contractor | Name, main contact and any risk flags. |
| Type | Subcontractor, Trade contractor, Consultant, Supplier or Staffing agency. |
| Cost centre | Their default expense account. |
| Demographic | Certified classifications such as Indigenous-owned, Women-owned or Local / regional. A lapsed certification is struck through. |
| Prequal | Not started, In progress, Approved, Approved with conditions or Rejected. |
| Insurance / WCB | Expiry dates. |
| In the budget | Their dollars in this budget and share of it, such as 18,000.00 · 21%. |
Add a contractor asks for the name, type, Cost centre, main contact and email, prequalification status and note, insurance and WCB clearance expiry dates, and any number of Demographic workforce classifications, each with Certified by (CCAB, WBE Canada, self-declared…) and an expiry. Editing adds an Active switch. Deleting asks Delete “{name}” from the register? — the register is shared by every opportunity in the workspace.
The bid build-up
Tansi works out the price you should bid from your costs. The build-up shows each step and lets you set the three percentages:
| Row | How it is worked out |
|---|---|
| Our own team | Self-perform lines, at your own rates. |
| Subcontract and supply | Subcontract and supply lines. |
| Bid costs | Added here only when charged to the client; otherwise marked Not charged. |
| Direct cost | The sum of the above. |
| Overhead | A percentage of direct cost — office, insurance, bonding, IT. |
| Contingency | A percentage on direct plus overhead. |
| Cost to deliver and win | Everything so far. |
| Margin | A percentage on cost to deliver. |
| What we should bid | The answer. |
Under it: Real margin after bid costs: {x}. and The bid costs are {n}% of the bid. When uncharged bid costs push the bid into a loss, it says so plainly: This bid returns a loss of {amount} once the bid costs not charged to the client are counted. Charge the bid costs, raise the margin, or cut the scope.
Pricing: the price sheet, revisions and sending a quote
The price sheet is What the client sees: choose the lines, how prices are shown, and save numbered revisions to preview, download or send as a quote. It has four numbered parts.
1. What goes on the price sheet
Tick the lines to include; untick one to leave it out of the bid. Tick Optional to price a line separately below the total, so the client can choose to add it. The summary reads 12 of 14 lines included · 2 optional. Some ticks are locked, with the reason: The line above it is left out., The line above it is already optional., Bid costs can't be optional.
2. Client prices
Prices are worked out from your costs and the build-up's markups. Type over any price to change it by hand — it is marked Edited with a Reset button beside it.
- How the client sees the price: Section totals, Every line, Every line, by section or One total. One total asks for a Description of the one total.
- Optional items are listed under Optional items (priced separately, not in the total).
- Subtotal, Tax rate (0 to 100) and Total.
- Markups shows the bid build-up, then Price we're submitting, Difference from the worked-out bid and Real margin.
If you changed prices by hand, a sentence keeps you honest: You changed 2 prices by hand: $41,500.00 against the worked-out bid of $43,120.00. Real margin is now 8.4%.
3. Revisions
A revision is a saved copy of the client prices. Create price sheet makes Revision 1; after that the button reads Create Revision {n}.
- Blocked: You can't create Revision 3 yet. Fix these first: followed by problems such as “Steel” needs vendor pricing chosen. or “Permits” is required and has no price., with Go to Vendor prices or Go to Budget lines.
- Nothing new: Revision 2 matches the price sheet. Nothing has changed, so there's nothing new to save.
- Changed: Changed since Revision 2 with the first eight changes listed (Added, Removed, price changes, layout, tax rate, renamed) and and {n} more.
| Revision status | Meaning |
|---|---|
| Draft · current | The latest revision, matching the sheet. |
| Draft · 2 changes since | The latest revision, but the sheet has moved on. |
| Replaced | An older revision. It cannot be sent as a quote. |
| Submitted · locked | Recorded with a submission. The price sheet is locked. |
Each revision row has Preview and Send as quote, shows Sent as Q-1042 once sent, and notes 2 prices edited by hand. Tick exactly two revisions for Compare selected, or any number for Download selected.
Compare shows Revision 1 compared with Revision 2: each item's price in both, the change, Subtotal and Total with tax. If the two use different layouts, it warns that some items appear in only one.
Format and preview
Preview opens Price sheet Revision 2: format and preview. Pick a Format — Standard (built in) or one your administrator saved — and adjust it for this document; the label Changed for this document tells you you have. Then Open to print, Download PDF, or Use for this opportunity.
| Option | Choices |
|---|---|
| Layout | Classic (letterhead with a colored rule), Modern (colored banner, large total), Government price form (black and white boxes, numbered rows, bidder block), One-page summary. |
| Colour | Tansi teal, Navy, Charcoal, Forest or Plum. The government form always prints in black and white. |
| Show | Logo; GST line and total with tax; Optional items; Page numbers. |
| Text size | Normal or Large. |
| Wording | Cover letter; Prices valid for (days), 1 to 3,650 — Shows “valid until” with the date worked out for you; Terms and conditions; Footer note; GST/HST number on the letterhead. |
| How the client accepts | “Accept online” link (quotes only), Signature lines, Both or Neither. |
The terms box says it: Tansi doesn't write terms for you. Blank means no terms section. Paste your own payment, validity and inclusion terms, or the document goes out without any.
Also save to “{format}” writes your changes back into the saved format for next time. Only CRM admins can change formats; others get Only CRM admins can change formats.
Sending a revision as a quote
- Select Send as quote on the current revision.
- Tick recipients under To — the account's contacts with an email — and add others in Other email addresses, separated by commas.
- Check the Subject (Quote for {opportunity} (Revision 2)) and the Message. The link to view and accept the quote is added after your message.
- Choose a Format, or Edit options and preview.
- Under Attachments, add other price sheets or documents. The quote PDF is always attached.
- Select Send quote.
You will see Quote Q-1042 sent. It's in Activity and Quotes., or sent to 2 of 3 recipients, or was saved as a draft but couldn't be emailed. Send it from Quotes. If attachments were too big, Some attachments were too large; the client can get them online.
- At most 10 recipients per send.
- One of the recipients asked not to be emailed. — remove them; their opt-out wins.
- Add a billing address to the account before sending a quote.
- Only a current revision can be sent as a quote.
- The price sheet is locked after submission. — reopen the submission to change it.
A quote sent from a revision keeps that revision's lines: on the Quotes list it has no Edit. Section 4 of the price sheet is that Quotes list.
Vendor prices: requesting, comparing and choosing
Vendor prices sends vendors a private page with the items to price and the documents to review. Open any vendor to see everything they sent, including their files. Then compare and choose.
Building a request
New price request opens a four-step wizard: What to price, Vendors, Documents and cover page and Email. The step list shows Done or Needs attention beside each, and Send request tells you how many things are left to fix.
| Step | What you fill in |
|---|---|
| What to price | Request name; Prices due (today or later — Vendors can send prices until the end of this day. Our bid is due {date}.); Instructions for vendors; Questions for vendors (optional), one per line, up to 20; Budget lines to price, picked from a searchable tree (a ticked line covers the lines under it; lines already priced by a vendor are marked and cannot be picked); and Items the vendor will price — each ticked line adds an item you can rename, re-quantify, split, reorder or remove. Up to 200 items. |
| Vendors | Send to searches Procurement › Vendors and CRM › Contractors, grouped; ticking a group ticks everyone in it, and prequalification status shows beside each. Check the Contact name and Email for each. Add a new vendor saves a company straight to Procurement › Vendors. Up to 50 vendors per request. |
| Documents and cover page | What vendors receive: sections and documents in the order vendors will see them. Add documents from the opportunity or upload new files (up to 20 at a time). Private documents cannot be shared — an upload saved as private says so. Optionally Include a cover page, starting from a template or blank. |
| Start from the Standard message, a saved template, or Write my own; Subject and Message. Words in double curly brackets are filled in per vendor — use Insert a field so they are spelled right. Preview for shows the email for one vendor. Tick Save this as a new email template to reuse it. |
If the message has no link field, Tansi adds each vendor's private link at the end. A misspelled field is caught: These fields aren't ones Tansi fills in: … The subject cannot contain the private link or the item and document lists.
How vendors get the documents
| Option | What it means |
|---|---|
| Secure link (recommended) | Documents stay in Tansi. You can see who opened them and take access back at any time. Choose the Access — View and download, View only (can't download) or View only (can't download or print) — an optional PIN to open (4 to 8 digits, or Make one) and an optional Access ends date. Each vendor gets their own link. |
| Attach copies to the email | Copies can't be taken back. Attachments have a total size cap; if the files do not fit, vendors get the secure link instead. Attachments cannot have a PIN, an end date or view-only access. |
After sending: The PIN to open the documents is 482913. Give it to the vendors separately. Tansi won't show it again. It is never put in the email. Write it down before you close the message, or set a new one later from Document access.
Following replies
Each request shows its due date, item count, 3 of 5 vendors sent prices and prices chosen for 8 of 12 items, with a state: Taking prices, Closed or Prices chosen. Under it, one row per vendor:
| Column | Notes |
|---|---|
| Vendor, Source | Source is Vendor or Contractor. |
| Status | Sent, Opened, Prices in, Declined or Send failed. |
| Total, Missing prices | Missing counts the items they left unpriced. |
| Chosen, Files | Whether their prices were used; how many files they sent. |
| Vendor link | Revoke link — {vendor} won't be able to open the request or send prices anymore. This can't be undone. |
| Opened documents | Not opened, or Opened {date}, 3 times; Documents taken back. |
Request buttons: Compare and choose (View prices if you can only view), See as vendor, Document access, Close (stop taking prices) or Reopen, and Delete — Vendors can no longer open it. Prices already used in the budget stay. Reopening after the due date asks for a New due date.
All vendor submissions switches to one list of every vendor across requests, with a search (Vendor, request, contact, what's included), Request and Status filters (including Chosen), and Grid, Tiles or Board layouts.
A vendor's proposal
Open any vendor to see their proposal: status, when prices were sent and how many times, Price holds until, any reason they declined, the item table (unit price, line total, Can't price), What's included, What's left out, notes, answers to your questions, and their files with a preview (images and PDFs up to 10 MB), Download and Full screen. Link to budget line attaches the proposal to a line so its files show as a paperclip there. Previous and Next step through the vendors.
Comparing and choosing
Compare and choose asks How do you want to choose?
- One vendor for everything — pick one; the cheapest is marked Lowest total.
- Choose per item — pick a vendor, or No vendor, for each item. Cells show Lowest, Chosen, Can't price or No price.
A price that holds only until before your bid is due is flagged Ends before the bid is due. The footer reads 8 of 12 items chosen, $56,200.00 in total. Use these prices writes them into your budget lines — Prices used: 6 lines added, 2 replaced, 4 items skipped. — and those lines get the Vendor price chip.
Vendor documents, access control and what a vendor sees
Document access
Document access on a request changes access after it has gone out. Its summary shows the method and settings, such as Secure link, PIN set and Until {date}.
| Setting | What it does |
|---|---|
| Access for everyone | The default access level for the request's documents. |
| PIN | Add a PIN, Change PIN or Remove PIN. A new PIN is shown once — New PIN: 4821. Send it to the vendors separately. The old PIN no longer works. |
| Access ends | Leave blank to keep access until you take it back. |
| Documents table | Per document: its section, its own access (Same as the request or a different level), and its own PIN or The request's PIN. |
| Vendors table | Per vendor: Opened {date}, 2 times or Not opened; Active, Taken back or Link taken back; Take back access or Give access back. |
Take back access from everyone and Give access back to everyone act on all vendors at once. The dialog explains the limit: Taking back access stops the vendor opening the documents straight away. It doesn't affect their price form or what they already sent you. If the documents went as attachments, it warns that vendors have their own copies and those can't be taken back.
See as vendor
See as vendor opens the vendor portal under a banner — This is exactly what {vendor} sees. Nothing you do here is saved. Switch vendors with Viewing as, and leave with Back to Tansi CRM.
The vendor's request page
A vendor opening their link sees {your company} is asking for your price, the due date, what it is for, and then:
- Cover page, if you included one.
- Review these documents — Download or Open each, with chips such as View only, View only, no printing or PIN, and a line about access: You can open the documents until {date}., Access to the documents ended on {date}., or The sender has taken back access to the documents. You can still send your prices.
- Price each item — Your unit price per item, a Can't price tick, and Your total. At least one price is required.
- Answer a few questions, if you asked any.
- Tell us the details — What's included, What's left out, Price holds until, Notes.
- Your files — Add files, with the limit shown as Up to {n} files, {m} MB each.
- Submit prices (later Update prices), or Decline to quote with an optional reason.
The footer says This link is personal to your company. Please don't forward it. A closed request stays readable: This request is closed. You can still read it and download the documents. A revoked link reads This link is no longer active. Please contact the team that sent it to you. Rapid repeated actions are slowed down: Too many actions in a short time. Please wait a few minutes and try again.
PINs and the view-only viewer
A PIN-protected document asks Enter the PIN — {document} is protected with a PIN. Ask the sender if you don't have it. Wrong tries count down (That PIN isn't right. 2 tries left.) and then lock for a while (Too many wrong tries. Try again in {n} minutes.).
View-only documents open page by page in Tansi's viewer — Page 3 of 12 — with View only. Downloading is turned off. or View only. Downloading and printing are turned off. The viewer is honest about it: This makes copying harder, but it can't stop someone taking a photo or screenshot. A file type the viewer cannot show tells the vendor to ask you for a copy.
Use view-only and PINs to keep honest people honest and to know who opened what. For drawings or specifications that must not leave your hands, do not send them to that vendor at all.
Submission: checklist, addenda and recording the bid
The Submission tab is A checklist of everything you have to hand in, grouped the way the RFP asks for it, plus the buyer's addenda. Record the submission once it's sent: that locks the price.
Sections and parts
Sections (such as envelopes or volumes) hold the parts the RFP asks for. Use Add section and Add part, or Apply template to start from a submission template — Adds the template's sections and parts that this opportunity doesn't have yet (matched by name). Nothing is removed or changed. Drag a row to reorder or move it to another section, or use the up and down arrows; numbers update by themselves. A section can only be deleted once it is empty.
| Column | Notes |
|---|---|
| # | The part's number, such as 2.3. |
| Part | Name, required marker, and a page limit such as 10-page limit. |
| Owner | Who prepares it. Automatic for the part that fills in from Pricing; Someone outside this workspace when the person has left. |
| Due | Marked when overdue. |
| Documents | Download links. The price sheet appears as Made from Pricing. |
| Status | Not started, In progress, Ready for review or Approved. |
| Actions | Edit, move, delete. |
A progress bar counts Required parts approved.
The part dialog asks for Part name (unique within the section), Section, Type (Document, Tansi Form, Signed proposal, Other, or Fills in from Pricing), Owner (No one yet is allowed), Due, Page limit (optional), Required, Notes (optional), and Documents — Add from Documents or Upload. Deleting a part keeps its files: Its documents stay in Documents.
A part of type Fills in from Pricing gets the price sheet's current revision attached by Tansi. It's approved when the price sheet has no changes since that revision. Its status reads Approved (price sheet current), Price sheet has changes or Waiting for the price sheet, and you cannot set it by hand.
Addenda
Changes the buyer sends out after the RFP. Acknowledge every addendum before you submit; one that affects the price needs the price checked again. Log addendum asks for the Addendum number, Issued date (required), Received (optional), What changed, the Impact — Affects the price and/or Affects the checklist (new or changed parts) — and the Addendum file.
The table shows Acknowledged (Yes, {date} or Not yet) and Price checked: Not needed, Yes, a later price sheet revision, or a Price checked, no change tick for when you looked and the price stands. Logging a price-affecting addendum reminds you: This addendum affects the price. Check Pricing.
Ready to submit?
| Check | Passes when |
|---|---|
| Required details | The opportunity's required fields are filled. |
| Price sheet | Its current revision has no changes or problems since it was made. |
| Required parts approved | Every required part is Approved. |
| Addenda acknowledged | Every addendum is acknowledged. |
| Price checked after addenda | Each price-affecting addendum has a later revision or a no-change tick. |
| Sent by the deadline | The submission deadline has not passed. |
Each missing item has a Fix link. The verdict is Everything is ticked., or Some items aren't ticked. You can still record a submission that was sent; you'll be asked to confirm., or blocked: The price sheet has changes or problems since its current revision. Create a new revision (or fix the problems) before recording the submission.
Recording the submission
- Select Record the submission. The dialog says This locks the checklist and the price sheet at Revision 3.
- Choose How was it sent? — Online portal, Email, Courier, Hand delivered or Other — and add Details (optional) such as the portal's name.
- Enter the Date and time sent (not in the future).
- Enter the Confirmation number from the portal receipt or email reply, or type none.
- Add Notes and upload the Receipt (optional) — it is saved to Documents as an internal file.
- If items are still open, tick Record it anyway: it was sent like this.
- Select Record and lock the price.
The tab then shows Submitted {date} with the confirmation, Price locked at Revision 3., Sent after the deadline. when it was late, and Recorded with these items open: … when you recorded it anyway. Tansi also files a dated Submitted snapshot folder in Documents that cannot change.
Once recorded, the checklist and the price sheet cannot change — The submission has been recorded. Reopen it to make changes. Reopen submission unlocks both, for example to send a corrected bid. The record stays in the history. Earlier submissions are listed under Earlier submissions with their confirmation and reopen date.
The Proposals list sits at the bottom of this tab. A converted opportunity's submission is read-only.
Quotes, invoices, contracts and proposals
Quotes, proposals, contracts and invoices live on tabs of the opportunity or project record. Each has an editor dialog, a signers dialog, a send-document dialog and a public link. Rows inherited from a source opportunity appear on the project read-only, marked From the opportunity.
Getting a quote out
A quote usually starts in the Pricing tab's Price sheet, which keeps revisions and can Send as quote. Three guardrails will stop you, and each has a reason:
- The price sheet is locked after submission. What you handed in cannot change.
- Only a current revision can be sent as a quote. An old revision is history, not an offer.
- Add a billing address to the account before sending a quote. A quote without an address to bill is not finished.
A send goes to at most ten recipients. The look of the document comes from a quote and price sheet format set in CRM Settings; you pick one at send time and can change anything for that one quote.
What the client sees — a quote
The public quote page shows the estimate, any Attachments with Download, and the response buttons. Accepting asks the reader to Type your full name to accept beside the sentence I accept this estimate. Declining offers an optional reason. Status chips run Draft, Waiting, Accepted, Declined, Cancelled and Expired.
The terminal states are worded for the client, not for you: This estimate has expired. Please request a new one., This estimate can no longer be responded to because its project is closed., and This estimate is not ready for a response yet.
Invoices
The public invoice page is read-only, with attachments and a download, and shows whether the invoice is Paid (with the date), Cancelled, Draft or Sent.
Contracts and proposals
Sign contract shows the contract number and the party it is for, a signer list marked Pending, Signed or Declined, a count of how many of the parties have signed, and a box reading Type your full legal name to sign beside I agree to the terms of this contract. When everyone has signed, the page says This contract is fully signed and offers Download a copy.
A later party who opens their link early is told It's not your turn yet — an earlier party still needs to sign. If a signature is holding things up, chase the party above them in the list, not the one complaining.
Sign proposal follows the same pattern and adds a line-item table of Description, Qty, Unit, Amount with a subtotal, tax and total, and a Terms & Conditions section. The consent sentence is I agree to this proposal and its terms.
Every acceptance page states it: This is a lightweight electronic record of agreement, not a certified or qualified e-signature. For most commercial work that is sufficient. Where a regulator or a counterparty requires a qualified signature, use the tool they require and attach the result to the record.
The client portal
One link can carry all of it. /crm/portal/{token} is headed Shared with {name} by the {tenant} team and gathers Needs your signature, Quotes & estimates, Invoices, Documents (with · yours marking files the client uploaded), Notes, Tasks and Activity.
Clients can send things back: Write a note and Post a note, Upload a file, Ask for something (what do you need, plus details) and Request a meeting (topic plus preferred times). The footer warns This link is personal to you — please don't forward it, and a dead link reads This link is no longer active. Please contact the team that shared it with you.
Unsubscribes and email polls
Two small public pages complete the set. Unsubscribe has three states — invalid link, already unsubscribed, and You've been unsubscribed and won't receive further emails from us. An unsubscribe through that link is recorded on the contact's preferences with its source, so the audit trail stays intact. Poll confirms an answer clicked in an email, says the answer can be changed by clicking a different option in the email, and shows the running result.
What happens when someone declines
- On a quote, Decline opens an optional Reason (optional) box with Back and Confirm decline. Accept stays unavailable until the reader has typed a name and ticked the box.
- On a contract, Decline takes effect at once — no reason, no second question. A declined contract then shows This contract is no longer available for signing. to every party, so a new one has to be sent.
- Signing pages show who the link belongs to — Signing as {name} or Accepting as {name} — and, once that person has signed, You have signed. Awaiting the remaining parties.
- An expired signing link reads This signing link has expired. Please request a new one.
The portal and polls, in detail
- In the client portal each quote has View and Hide, and can be accepted or declined right there. Invoices show Paid, Cancelled, Due or Draft; tasks show Pending, In progress, Completed, Cancelled, On hold or Awaiting approval.
- Opening a poll link without an answer shows This poll is in the email we sent you — click an answer there.
- Newer campaign footers also credit an unsubscribe to the campaign that sent the email.
Quotes and invoices on a record
Quotes and invoices each have a list on the opportunity or project. On a project with no CRM account, an information line replaces the New button, because there is nobody to bill. In view-all mode with no workspace picked, Tansi asks you to pick one first.
The Quotes list
| Column | Notes |
|---|---|
| Number | With the From the opportunity chip on a project's inherited quotes. |
| Status | Draft, Awaiting response (sent), Accepted, Declined or Cancelled. |
| Total, Issued | The quote total and issue date. |
| Expires | Adds (expired) when the date has passed and the quote is still Draft or Awaiting response. |
| Created by | Who made it. |
| Client | Internal only or Shared with client — the portal chip. |
The row menu holds View, Copy Public Link, View Public Link and Download for everyone, and, if you can edit:
| Action | What it does |
|---|---|
| Edit | Opens the quote editor. Missing on quotes sent from a price sheet revision — they keep that revision's lines. |
| Send | Asks for the recipient (prefilled with the account's email): The quote PDF and a public link for accepting online will be emailed to:. Sends the PDF plus the quote's shared documents, in the recipient's language, logs it on the timeline and sets the status to Awaiting response. |
| Mark as Sent | Drafts only. Makes the public link live for a response without emailing — for a quote you delivered some other way. |
| Delete | Removes the quote immediately. There is no confirmation. |
| Create Invoice | Makes an invoice from the quote and opens it — Invoice {n} created — the quote is kept. Grayed out while that invoice exists; deleting the invoice makes it available again. |
| Cancel Quote | Sets the status to Cancelled. |
| Create Duplicate | Copies it as a new draft and opens it — Quote duplicated as {n}. |
The quote and invoice editors
Both editors show the number, then header fields — Expiry date on a quote, Due date on an invoice — plus Tax rate (%) (0 to 100) and Notes. Line items have Description, Account (only when your workspace has a chart of accounts), Qty (whole numbers, at least 1), Unit price and the line Total, with Add line. Quotes also offer Add from inventory when Inventory is turned on: it adds the item's description and price at a quantity of one.
Totals update as you type: Subtotal, Tax (x%) and Total. Underneath, Attached documents takes files by drag and drop, each with a Private switch — Private documents are not emailed or shown on the public page.
Saving needs at least one line with a description — Add at least one line with a description before saving. Any other line left without a description is removed silently, price and all. Describe every line you mean to keep.
The Invoices list
Columns: Number, Status (Draft, Sent, Paid or Cancelled), Total, Issued, Due and the Client chip. Empty: No invoices yet. Create one here, or convert a quote via its “Create Invoice” menu item.
The menu matches quotes — View, Copy Public Link, View Public Link, Download, Edit, Send — plus Mark as Sent (drafts), Mark Paid, Cancel Invoice and Delete. Sending says The invoice PDF and a public viewing link will be emailed to:, and a draft becomes Sent once the email goes. Delete has no confirmation.
When you send a quote or invoice, Tansi attaches the PDF and then the record's shared documents until the email reaches its size limit. Anything that does not fit is left off and the email tells the client they can get it online. Private documents are never attached.
Viewing
View shows the document as the client will see it: INVOICE or ESTIMATE, Billed to with the account's billing address, the number, Issued, Valid Till or Due, the lines (Description, Quantity, Unit Price, Amount), Sub Total, Tax, Total, Note and Project. A quote's view also lists its attached documents.
Quotes and invoices on a project
A project lists its own quotes and invoices and its source opportunity's, marked From the opportunity. Inherited rows offer view, copy link and download, and two extra actions:
- An inherited quote that was Accepted can be invoiced on the project — the new invoice belongs to the project.
- An inherited invoice that is Sent can be marked paid from the project. Only the status changes; its contents stay read-only.
Contracts and proposals on a record
Contracts live under Contract & billing; proposals sit at the bottom of the Submission tab. Both use the same signer model and the same public signing pages described earlier in this module.
The Contracts list
New contract creates a draft titled Contract and opens Edit contract straight away. The list shows Number, Status (Draft, Sent, Signed, Declined or Voided), Title and Date — signed, else sent.
| Button | When |
|---|---|
| Edit | Draft only. |
| Send | Draft only. Emails the signers whose turn it is. |
| Void | Any status except Signed. |
| Delete | Always, and immediately — no confirmation. |
| Signers | Opens the signer status dialog. |
| Downloads Contract-{number}.pdf. |
On a project, contracts from the source opportunity offer only Signers and PDF; they are edited, sent and voided on the opportunity.
Editing a contract
| Field | Notes |
|---|---|
| Title | Required — Title is required. |
| Signers | Name, Email and Order per row. Add signer gives the new row the next order number. The last row cannot be removed. |
| Expiry date | When the contract lapses. |
| Contract body | The terms, as plain text. |
The caption explains the order numbers: Equal order = sign in parallel; higher numbers sign after lower ones. Two people at order 1 sign at the same time; the person at order 2 waits until both have signed. Rows without an email are dropped when you save, and at least one signer with an email is required.
Sending and following signatures
Send emails only the signers whose turn it is — the lowest order number still pending — and only those with an email. You see Contract sent for signature., or No pending signers to send to. The send is logged on the record.
Signers shows 1 of 3 signed, each signer's Order and Status (Pending, Signed or Declined), and Copy link — Signing link for {name} copied. Copying a link is how you resend to one person, for example after their email went to spam.
Proposals
New proposal opens Edit proposal:
- Title (required), Valid until, Tax rate (%).
- Signers, with the same order rules as contracts.
- Introduction — rich text that opens the proposal.
- Line items — Description, Qty, Unit price, Total; Add line; Add from inventory when Inventory is on. Totals show in the proposal's own currency.
- Terms & Conditions — rich text.
The list shows Number, Status (Draft, Sent, Accepted, Declined, or Expired once a sent proposal passes its Valid until date), Title, Total and Date. Edit and Send work on drafts. Send emails the current signers with the PDF attached — Proposal sent. — or warns No pending signers with an email to send to. The signers dialog's copy button says Acceptance link for {name} copied.
Once a contract or proposal leaves Draft, Edit is grayed out. To change the terms of a sent contract, void it and create a new one; for a proposal, create a new one.
Billing schedules and the contract summary
An opportunity's Contract & billing tab opens with two panels: Contract and Billing schedule. Below them sit the Contracts and Invoices lists.
The Contract panel
Contract value reads {amount} before tax, or Not known yet. The line under it says where the number came from, which tells you how firm it is:
| Source line | Meaning |
|---|---|
| From the award recorded when the opportunity was won. | The firmest: the awarded value. |
| From price sheet revision 3, as submitted. | The price you handed in. |
| From price sheet revision 3 (not submitted yet). | Your current price, not yet sent. |
| From the opportunity's estimated amount. | A guess — Record the award or submit a price sheet to firm it up. |
| Record the award, make a price sheet or enter the opportunity's amount. | Nothing to go on yet. |
Then the Contract or award number, the Term ({start} to {end}), the PO number, and each contract's status in words — Draft, Sent for signature, Signed on {date}, Declined or Voided — or None yet. Create one in Contracts below.
The billing schedule
Payment milestones, before tax. Create each invoice when its milestone is reached. Add milestone appears if you can edit and the opportunity has not been converted.
| Column | Notes |
|---|---|
| Milestone | Its name. |
| Share | A percentage such as 30 %, or Fixed. |
| Amount (before tax) | Worked out from the share, or the fixed amount. |
| Due | The due date. |
| Status | Planned, Ready to invoice, Overdue, Invoice drafted, Invoice sent or Paid. |
| Invoice | The invoice number, a Create invoice button, or Not invoiced. |
| Actions | Edit, move up, move down, delete. |
Two footer rows keep the schedule honest: Scheduled totals the milestones, and Difference reads The schedule matches the contract value., {amount} of the contract value isn't scheduled yet., or The schedule is {amount} over the contract value.
Adding a milestone
- Select Add milestone and name it (up to 200 characters), such as Mobilization or Final acceptance.
- Under How much, choose A share of the contract value or A fixed amount. A new milestone starts with the share that is still unscheduled.
- Enter the Share (%) — the dialog previews it, That's $12,000.00 before tax. — or the Amount before tax.
- Set the Due date and the Status: Planned or Ready to invoice.
- Optionally tie it to a Price sheet revision and add Notes (shown on the invoice).
- Select Save (Milestone saved.).
A share is more than 0 and at most 100 %, with up to four decimals; an amount is more than zero, to the cent. A share-based milestone follows the contract value, so if the value changes, so does the amount — until it is invoiced.
Create invoice drafts the invoice and tells you where to finish: Invoice INV-0042 drafted for Mobilization. Review and send it from Invoices. From then on the milestone's status follows that invoice.
Once a milestone has an invoice you cannot change it — This milestone has been invoiced. Cancel or delete the invoice to change it. A milestone with no amount cannot be invoiced either: This milestone has no amount yet: set the contract value or a fixed amount.
Deleting asks Delete the milestone «Mobilization»? with Yes, delete or Keep it. Milestones also appear on the opportunity's Schedule as one-day diamonds. The schedule exports from its own menu.
Reports
/crm/reports is headed Sales reports, subtitled Pipeline, forecast and activity for {period}. Without access the page says You don't have access to CRM reports.
Choosing a period
The reporting period control groups its options into Year, Half, Quarter, Rolling and Custom: this year to date, this year, last year, first half, second half, previous half, this quarter, last quarter, last 30 days, last 90 days, and a custom range with From and To.
Group by sets the grain — Week, Month or Quarter. The page tells you what it did (Showing {period}, grouped by {grain} — {n} {grain}s in range) and when it refused (Grouped by {grain}: {x} would be more than 60 bars).
Headline figures
| Figure | What it counts |
|---|---|
| Open pipeline | Open deal value, with the deal count and the as-at date. |
| Weighted | The weighted total, shown as a percentage of open value. |
| Won this period | Won value and deal count. |
| Win rate | The ratio, with the won and lost counts beside it. |
| Avg sales cycle | Days, noted as lower is better. |
| Overdue tasks | Open tasks past their due date. |
Each carries a change against the previous period.
Charts, each with a table
- Open pipeline by stage — Right now — every stage, including the empty ones.
- Forecast by close month — Total against weighted, so the gap is visible.
- Activity by type — stacked, at the grain you chose.
- Why deals were won and lost — the reasons, with a Manage loss reasons link for administrators.
Every chart has a View as Chart and Table switch. The table is not a fallback — it is the better view when you want the numbers rather than the shape, and it is what a screen reader reads.
The grids
- Performance by owner — Owner, Open, Open value, Weighted, Won, Win rate, Avg cycle. Sortable from any column heading.
- Due this month — open deals whose submission deadline falls in this calendar month, using the expected award date where there is no deadline.
- Stalled deals — open deals with no activity or edit for 21 days or more — a fixed number, not a setting — showing the stage and the days since the last touch.
Export all produces one workbook with a sheet each for pipeline by stage, forecast by month, activity by type, won and lost reasons, by owner, due this month and stalled deals.
Two things the page will tell you, if you read it
A note under the period control reads Figures are in {CAD}. {n} deals in {other} aren't in the money totals. Those deals are in your pipeline. They are not in these numbers. Before you present a forecast, read that line and say what it says.
When a refresh fails, the page keeps the last good figures and says so: The reports couldn't be updated. The figures shown are from the last successful load — try again. Numbers on screen can be a few minutes stale. The banner is the only thing that tells you, so do not screenshot past it.
Which currency, and where the missing deals went
Reports use the currency with the largest open pipeline; if there is a tie, or nothing is open, the currency with the most deals. Deals in other currencies are counted in the note under the period control.
Forecast by close month uses each deal's expected award date. Deals expected before or after the range, and deals with no expected date, are listed under Not shown rather than silently dropped.
The Manage loss reasons link only appears for people with the CRM admin permission.
CRM Settings
This section and the next need the CRM admin permission. Everything in them changes what your colleagues see across the whole module, so read the scope bar before you change anything.
/crm/settings is headed CRM settings, subtitled Pipeline stages, custom fields, picklists, tags, lead, calling and financial settings. Each panel has its own URL, so you can link a colleague straight to one.
The scope bar
The bar at the top says either Changes apply to this workspace or Changes apply to every workspace. The first explains itself: These settings belong to one workspace. Nothing here affects the others.
When a developer edits the global defaults, the bar warns: You are editing the global defaults. Every workspace that has not overridden these will change — including workspaces you cannot otherwise see. If you can read that sentence on your screen, it applies to you.
Users who can view all workspaces get a Workspace selector. Developers can choose Every workspace (global defaults); everyone else is asked to choose a workspace.
The thirteen panels
| Panel | What it configures |
|---|---|
| Chart of accounts | The account codes quote, invoice and cost lines are coded against. The same panel is also its own page — see the next section. |
| Units of measure | The units in every unit list, including Unit and Unit 2 on budget lines. |
| Pricing templates | Reusable sets of budget lines. |
| Submission templates | Reusable lists of submission sections and parts. |
| Quote and price sheet formats | Letterhead, layout, style, accent and terms. |
| Vendor request templates | The emails and cover pages for vendor price requests. |
| Vendors and contractors | The register you can send price requests to. |
| Custom fields | Extra fields per record type. |
| Pipeline stages | The pipeline board's columns and their probabilities. This is the panel the page opens on. |
| Picklists | The choices behind each dropdown. |
| Tags | Rename, recolor and delete the tags already in use. |
| Leads | The going-cold threshold. |
| Calling | Softphone behavior, queues, voicemail and the phone menu. |
Pipeline stages
The columns on the pipeline board, in order. Probability drives the weighted forecast. The table shows Order, Name, Probability, Type (Open, Won or Lost) and Status, with New stage.
A new workspace reads the default stages — This workspace uses the default stages. — and nothing is editable until you select Customize for this workspace, which copies the defaults in. After that, changes apply here only.
Reset to defaults is refused while a deal is still sitting in one of the workspace's own stages, so move those deals first.
A stage that still holds deals cannot be deleted — its Delete button is unavailable and says why — so edit it and set it inactive. When a stage is free to delete, the confirmation still offers Make it inactive instead: setting it inactive keeps the history and stops it being offered on new deals. Take that offer — it is almost always what you meant.
Custom fields
Pick a Record type — Lead, Contact, Account, Opportunity or Project — and manage Order, Label, Key, Type, Required, Status. The types are Text, Number, Date, Yes / no, Picklist, Email, Phone, Web address and Long text.
The panel explains why: The key is what integrations and exports use, so it can't change once anything is stored against it. Choose the key carefully on day one. The edit dialog locks the key as soon as the field exists — Fixed once created — even before any record holds data. The label can be changed later; the key cannot.
A field that holds data on any record cannot be deleted; edit it and make it inactive. An unused field can be deleted, and the confirmation offers Make it inactive instead, like stages.
Picklists
Pick a Field — lead status, lead source, account type, activity type, contact type or loss reason — and manage Order, Label, Kind, Visibility, Default, with New value and Make default.
Built-in values can be hidden or renamed but never deleted, because reports depend on them. A custom value that is in use cannot be deleted either — edit it and set it to hidden. An unused custom value can be deleted, and the confirmation offers Hide it instead. The loss-reason list is deep-linked from the lost-opportunity dialog, which is how most administrators arrive here.
Tags
There is nothing to add on this panel. Tags are created as people type them on a record; Settings only renames, recolors and deletes them. Renaming updates every record carrying the tag. Deleting takes it off those records — the warning counts them and offers Rename it instead.
Edit tag has a Name — Renaming updates every record carrying this tag. — and a Colour palette that includes Default colour (No colour — the standard chip). Two tags cannot share a name: A tag called “{name}” already exists. On a contact, tags are added in the Add a tag box: pick one, or type a new tag and press Enter.
Leads and Calling
The Leads panel holds one setting: the Going-cold threshold (days), with the default and the permitted range shown. It drives the Leads list's Going cold view and the staleness pill on a lead record.
The Calling panel sets how often agents are asked whether they are still available and how long they get to reply, how long agents ring before voicemail, whether unanswered callers can leave a voicemail, the greeting read aloud by text-to-speech, and whether to play a menu — press 1 for sales, 2 for support, or dial an extension — with its prompt. Queue and extension editors and call routing live here too.
Call routing lives in the Calling panel. Menu digits summarizes which digit reaches which queue. If the menu is on but no queue has members, a warning says callers will go straight to voicemail.
| Item | Fields |
|---|---|
| Queue | Name (up to 60 characters); Menu digit 1–9 — Leave empty for an extension-only queue; Default queue (callers who press nothing end up here); Member roles — Everyone holding one of these roles in this organization rings for this queue; Member users; and Voicemail greeting for this queue (optional), up to 500 characters. |
| Extension | Extension (2–5 digits), then Rings one person (pick the Person) or Rings a queue (pick the Queue). Callers can dial an extension followed by # at the menu. |
Removing a queue warns Extensions that ring it are removed too; call history keeps the name. Any queue except the default can be made the default with the star button.
Units, templates, formats and vendors
- Units of measure — Short name, Full name, Type, Used, Show in lists, Order, saving as you go. Changing a short name updates every line that uses it. A unit in use cannot be deleted; untick Show in lists instead.
- Pricing templates — reusable budget lines, up to eight levels deep, with a Default for opportunity type that replaces any other template's default for that type. Applying a template adds the lines it is missing and changes nothing already there. No templates ship built in.
- Submission templates — reusable lists of submission sections and parts, applied the same way. None ship built in either.
- Quote and price sheet formats — letterhead company details, a live preview with sample prices, and New format, Duplicate and Delete. Until a format exists, quotes use the built-in Standard format.
- Vendor request templates — the emails and cover pages you start from. Tansi fills in the fields in double curly brackets for each vendor.
- Vendors and contractors — everyone you can send a price request to, from two sources: CRM contractors you add and edit here, and procurement vendors kept in Procurement › Vendors and listed here so you can find them.
The warning says so: quotes already sent keep the look they were sent with, and price sheets using the deleted format fall back to your first format. You are changing the future, not rewriting the past.
A vendor that a budget uses cannot be deleted — {name} can't be deleted because a budget uses it. Edit it and turn off Active instead. The same pattern as stages, fields, picklist values and units: history wins, and deactivation is the way out.
One last mechanical detail worth knowing: settings panels discard stale loads, so a slow panel finishing after a faster one will not overwrite the newer data.
Limits in the settings dialogs
| Dialog | Field limits and rules |
|---|---|
| New stage / Edit stage | Name up to 100 characters and unique; Probability 0 to 100; a type of Open (A deal is still in play.), Won (Counts towards revenue.) or Lost (Asks for a reason.); and a status. |
| New field / Edit field | Label up to 150 characters; Options one per line for a picklist; Key up to 60 characters, starting with a letter, using lowercase letters, numbers and underscores, and unique on that record type; Required?; status. |
| New value / Edit value | Label up to 150 characters and unique in the list; Visibility visible or hidden. |
Each panel has its own address, such as /crm/settings/picklists, and the picklists panel accepts ?field=LossReason to open on one list. Removing things safely is covered in the section on deleting, hiding and deactivating settings.
Chart of Accounts
The Chart of Accounts needs the CRM admin permission. The same component also appears as the first section inside CRM Settings, so changes made in either place are the same changes.
/crm/admin/accounts is headed Chart of accounts, subtitled The account codes that quote, invoice and cost lines are coded against. The breadcrumb reads CRM › Settings, and the buttons are Keyboard and Add account.
The table shows Code, Name, Type — Income, Expense, Asset, Liability or Equity — Status (Active or Inactive) and actions, with usage shown as a count of lines. The empty state tells you what to do: Add the codes your quote, invoice and cost lines should be coded against.
The scope banner names the workspace you are editing. In view-all mode with no workspace picked, the page explains itself clearly: Viewing every workspace at once — Account codes belong to one workspace, so nothing can be shown, added or changed until you pick one above. Add account is unavailable for that reason, not because of a permission problem.
Adding, editing and deleting a code
| Field | What it is |
|---|---|
| Code | The number your bookkeeping uses, like 4000. Up to 20 characters, and unique in the workspace. |
| Type | Income, Expense, Asset, Liability or Equity. Decides which reports the account rolls up into. |
| Name | What appears on a quote or invoice line. |
| Active | Inactive accounts stay on old lines but can't be picked on new ones. |
Select Save account. Deleting asks you to type the account code to confirm. A code already on lines can still be deleted — Those lines keep it for reporting, but the code can't be picked again. — and Make inactive instead is offered as the gentler choice.
Add account opens a dialog for the workspace named under its title:
| Field | Help shown |
|---|---|
| Code | The number your bookkeeping uses, like 4000. Up to 20 characters. Codes are unique — Code {code} is already used by “{name}”. |
| Type | Decides which reports the account rolls up into. |
| Name | What appears on a quote or invoice line. |
| Active | Inactive accounts stay on old lines but can't be picked on new ones. |
Deleting opens Delete account {code}?. It says how many quote, invoice or cost lines use the code — those lines keep it for reporting — and suggests the gentler path: If you only want to stop people picking it on new lines, make it inactive instead — the history stays intact. To delete, type the account code to confirm; Make inactive instead is one click. Expense accounts are also the Cost centre choices on bid costs and contractors.
Deleting, hiding and deactivating settings
Everything here needs the CRM admin permission. Anyone who can open CRM Settings can change every panel — there is no separate view-only level inside it.
CRM Settings protects history. Old deals, records and lines keep pointing at the stage, field, value or code they were saved with, so Tansi will not let you pull one out from under them. Learn the pattern once and every panel behaves the same way.
When Delete is unavailable
A row that is in use keeps its Delete button, but the button is unavailable and names the reason for screen reader users, for example Delete Proposal sent — not available, the stage holds 4 deals. The reasons are:
| Setting | Why it cannot be deleted | What to do instead |
|---|---|---|
| Pipeline stage | It still holds deals, or it is the only active Won stage, or the only active Lost stage. | Move the deals, or edit the stage and set its status to inactive. |
| Custom field | It holds data on at least one record. | Edit it and make it inactive. |
| Picklist value | It is built in, or it is used on at least one record. | Edit it and set Visibility to hidden. |
| Unit of measure | It is used on at least one line. | Untick Show in lists. |
CRM contractors in the vendor register work a little differently: their Delete button is always available. After you confirm Delete {name} from the contractor register?, Tansi refuses if a budget uses the contractor, saying {name} can’t be deleted because a budget uses it. Edit it and turn off Active instead.
Inactive and hidden items stay on the records that already use them. They are only taken out of the choices offered for new ones.
When Delete is available
For an unused stage, field or value, Delete opens a confirmation headed Delete “{name}”? It says This cannot be undone. and Nothing is using it yet., and still offers the safer choice as a button: Make it inactive instead for stages and fields, Hide it instead for picklist values.
To delete, type the item's name exactly as shown — capital letters included — in the box labeled Type {name} to confirm. A mismatch shows That doesn’t match. Focus starts on Cancel, never on the red button.
Tags and account codes are different
- Tags can be deleted even when in use. The confirmation counts the records — It will come off 12 records. — and offers Rename it instead, which keeps those records grouped.
- Account codes in the chart of accounts can be deleted even when lines use them. The lines keep the code for reporting, but it can no longer be picked. You confirm by typing the account code, and Make inactive instead is offered beside the delete.
Stages have two extra rules
- Every workspace must keep at least one active Won stage and one active Lost stage, so the last of each cannot be deleted or switched off.
- If you delete the last stage your workspace customized, Tansi goes back to the default stages and says so: {name} deleted. This workspace now uses the default stages.
If you are unsure, choose inactive or hidden. It is reversible, it keeps reports honest, and it removes the clutter from everyone's dropdowns equally well.
Calling, texting and the going-cold threshold
These panels live in CRM Settings under Leads and Calling and need the CRM admin permission. Both belong to one workspace, so in view-all mode you are asked to Pick a workspace to edit these settings first.
The going-cold threshold
The Leads panel holds one number: Going-cold threshold (days). An open lead with no activity and no edit for that many days counts as going cold. The default is 7, and you can set anything from 1 to 365. Select Save lead settings; Tansi confirms with Saved — leads now go cold after {n} days.
The number drives the Going cold saved view on the Leads list, the amber highlight on a lead's last activity, the staleness pill on a lead record, and the No activity in {n}+ days row on CRM Home.
A busy trades contractor that calls back within the week might keep 7. A consultancy with long sales cycles might choose 30. Too short and the view fills with leads that are fine; too long and real leads go quiet unnoticed.
How inbound calls ring
Inbound calls ring the agents who have switched themselves Available. With the menu on, callers choose a queue or dial an extension; with it off, everyone Available rings.
| Setting | What it does | Limits |
|---|---|---|
| Ask agents if they're still available every (minutes) | How often an Available agent is asked to confirm they are still there. | Default 30, from 5 to 480. |
| Ring agents for (seconds) before voicemail | How long a call rings before it goes to voicemail. | Default 25, from 10 to 60. |
| Let unanswered callers leave a voicemail | On or off. | |
| Greeting read to unanswered callers | Read aloud by text-to-speech before the beep, or before hanging up when voicemail is off. | Up to 500 characters. |
| Play a menu (press 1 for sales, 2 for support, or dial an extension) | Turns the phone menu on. | |
| Menu prompt | What callers hear. Word it to match your queue digits; callers press a digit, or an extension followed by #. | Up to 500 characters. Shown only with the menu on. |
Select Save calling settings. The queue and extension editor sits further down the same panel.
Turning texting on
The Phone numbers table lists the numbers assigned to your organization, with Name, Number and a Texting (SMS) switch for each. Numbers are assigned by Tansi support; with none, the panel says No number is assigned to this organization yet. Numbers are assigned by Tansi support.
CRM texting stays off until at least one number has texting switched on — the panel warns CRM texting is off until texting is turned on for one of these numbers. Texts go out from the first number in the list that has texting on.
When staff see Texting needs a workspace phone number — contact your administrator, this table is where you fix it. After you flip the switch, users may need to refresh their page before the SMS buttons come back.
Units of measure, pricing templates and submission templates
These three panels are in CRM Settings and need the CRM admin permission. Changes save as you go — there is no Save button — and apply the next time someone uses the unit or template. Nothing already on an opportunity is changed.
Units of measure
Every unit list in the CRM — Unit and Unit 2 on budget lines, for example — comes from this panel. The table shows Short name, Full name, Type, Used (Not used or a line count), Show in lists and Order. Types are Time, Count, Distance, Area, Volume, Weight and Other.
Add a unit in the row at the bottom (e.g. wk, e.g. Weeks) and select Add unit. Until you add one, unit lists stay empty. Short names must be unique — “wk” is already a unit.
Changing a short name rewrites it on every line that uses it, and Tansi says how many: hrs renamed to h. 42 lines updated. A unit in use cannot be deleted; untick Show in lists to stop it being picked.
Pricing templates
A pricing template is the set of budget lines a kind of bid needs. None are built in, so start with New template. Applying one on an opportunity's budget lines adds the lines it is missing; nothing already there is changed or removed.
| Field | What it does |
|---|---|
| Template name | What people pick from. |
| When to use it | A short description. |
| Default for opportunity type | Offered on an empty budget of that type — RFP, RFQ, RFI, Tender, Sole source, Standing offer or Other. Choosing a type takes the default away from any other template. |
| Active | Only active templates can be applied. |
Each line has a Line name, Who does it (Our team, Subcontract or Supply), a Unit, an optional Unit 2, an optional Default unit cost, and two ticks: Required and Vendor price (the line needs a supplier's price). Buttons on each line add a line under it, move it up or down, and move it in or out a level. Lines nest up to 8 levels deep.
Duplicate copies a template as {name} (copy). Deleting a template asks first and reassures you that Budgets it was already applied to keep their lines. Deleting a line with lines under it asks too, and counts them.
Submission templates
A submission template is the checklist of sections and parts a kind of bid needs — a public RFP with two envelopes, say, or a simple quote. None ship built in. Give it a Name, a Description and set it Active; only active templates can be applied on an opportunity's Submission tab, where they add whatever is missing.
Add section creates a numbered section. Inside it, Add a part adds a row with a Part name, a Type — Document, Tansi Form, Signed proposal, Other or Fills in from Pricing — a Required tick and a Page limit. Sections and parts can be moved up and down.
Deleting a section asks first and counts its parts. Deleting a template keeps the checklists on opportunities that already used it.
A worked example
- A general contractor bids on municipal renovation tenders every month. The estimator opens Pricing templates and selects New template.
- She names it Interior renovation, sets Default for opportunity type to Tender, and adds sections for Demolition, Framing, Electrical and Finishes.
- Under Electrical she adds lines marked Subcontract with Vendor price ticked, so each one prompts for an electrician's quote.
- In Submission templates she builds Municipal tender with a Technical envelope (method statement, safety plan, each with a page limit) and a Financial envelope (a part that fills in from Pricing).
- Next month, a new tender's empty budget offers her template automatically, and the Submission tab fills its checklist in one step.
Quote formats, vendor request templates and the vendor register
These panels are in CRM Settings and need the CRM admin permission. Unlike the template panels, two of them need an explicit save — read the button labels.
Quote and price sheet formats
A format is the look of a quote or price sheet. You pick one when you preview a price sheet or send a quote, and can then change anything for that one quote. Until you add a format, quotes and price sheets use the built-in Standard format.
The list on the left marks each format has terms or no terms yet. New format creates Format {n}; Duplicate and Delete sit with the editor.
| Part of the editor | What you set |
|---|---|
| Company details on the letterhead | Company name, address, phone, email and website come from your workspace's company settings. Blank ones are left off. The GST/HST number is set per format. |
| Layout and Colour | The layout and accent color. The government price form always prints in black and white. |
| Show | Logo, the GST line and total with tax, optional items, page numbers. |
| Text size | Normal or Large. |
| Wording | Cover letter text, Quote valid for (days) or Prices valid for (days) (1 to 3,650; Tansi works out the valid-until date), terms and conditions, a footer note, and how the client accepts. Blank wording is left out. |
A live preview with sample prices redraws as you work. Select Save format; until you do, the editor shows Unsaved changes.
The terms box is empty on purpose — Tansi doesn't write terms for you. Blank means no terms section. Paste the terms your organization has approved.
Vendor request templates
These are the emails and cover pages you start from when you ask suppliers for prices. There are two lists, Email templates and Cover pages, each with a New button. With no email templates, the standard message is always available when you send a request.
Words in double curly brackets are filled in for each vendor. Use Insert a field so they are spelled correctly. If a message has no link field, Tansi adds the vendor's link at the end. A misspelled field blocks saving: These fields aren’t ones Tansi fills in: {list}.
| Field group | Fields Tansi fills in |
|---|---|
| The vendor | Company name, contact full name, contact first name, email. |
| The request | Request name, date prices are due, the vendor's private link, number of items, budget lines being priced, number of documents shared. |
| The bid | Opportunity name, client name, client's reference number, when your bid closes. |
| You | Your name, job title, email, phone, company, and today's date. |
The panel says Changes are kept only when you select Save. A new or duplicated template is not saved until you do. If you switch to another template with unsaved changes, Tansi asks whether to Discard or Keep editing. Requests already sent keep their text whatever you change later.
Vendors and contractors
This is everyone you can send a price request to, from two places:
- CRM contractor — kept in the CRM. Add contractor here; budget lines use them too.
- Procurement vendor — kept in Procurement › Vendors and only listed here. Open in Vendors takes you there to change one.
Filter with Search name, contact or email, a Source select (All, CRM contractors, Procurement vendors) and Show inactive. Columns are Name, Source, Contact, Email, Prequalification (Not started, In progress, Approved, Approved with conditions, Rejected) and Status. Delete on a CRM contractor asks you to confirm first, then refuses if a budget uses it; turn off Active instead.
Scenarios: from first enquiry to signed work
These walk-throughs string the screens together the way real work does. Each uses only features described in this module, so you can repeat them in your own workspace.
A renovation contractor answers a public tender
- A facilities manager at a school board fills in your website's lead form. A lead appears on the Leads list with the source you set in the form's Routing card, owned by the estimator you chose there.
- The estimator opens the lead, sees No next action, and selects Add a task to call back tomorrow.
- After the call she selects Convert lead, ticks Also create an opportunity, renames it from School board opportunity to the tender's title, enters the Amount, keeps the first open stage, and selects Convert. Tansi opens the new contact.
- On the new opportunity she selects Edit, sets the type to Tender, adds the solicitation number and website, and types the Submission deadline exactly as the buyer published it.
- Her default pricing template fills the budget; she sends price requests to two electrical subcontractors from the Pricing tab.
- Weeks later the board awards the contract. She drags the card onto Won on the Pipeline board, fills in the Contract # and Awarded value, then selects Convert to Project on the opportunity and sets the start and end dates.
- The site supervisor becomes Project manager, adds milestones for each phase, and updates % complete and Save each Friday.
An event venue handles a wedding enquiry
- A couple phones the venue. The coordinator selects New lead on CRM Home, enters their names, email and mobile with Can text ticked, and sets the Source to Referral.
- She logs the call on the lead's timeline and creates a task to send a quote by Thursday. It appears on My Activities under Next 7 days.
- The couple books a tour; she converts the lead with an opportunity for the package value.
- From the opportunity's Pricing she sends a quote. The couple opens the link, types their names and ticks I accept this estimate.
- She marks the deal Won. The accepted quote stays on the opportunity's record for the day-of team.
A home-care agency signs a referral partner
This example is from a health setting, but nothing in it is specific to medicine. The same steps fit a staffing agency, a property manager or any business that works through referral partners.
- The agency's business developer creates an Account for a regional clinic group, with Type set to Partner and Preferred contact method set to Email.
- She adds the clinic's intake coordinator as a Contact, picks the account in the Account field and ticks Primary contact.
- On the contact's Preferences tab she leaves Email campaigns on, because the coordinator asked for the monthly newsletter, and turns Text messages off, because the clinic does not allow texts to staff phones. The date and source of the change are recorded.
- She opens an opportunity for the partnership agreement, then marks it Won when the agreement is signed, recording the contract number and value.
- Back on the account, the Won value tile now shows the agreement, and the Contacts tile counts the primary contact.
Scenarios: keeping the CRM clean and current
A distributor tidies its accounts
- The office manager at a building-supply warehouse opens Accounts and reads the banner: 38 of 412 accounts are missing an industry or phone number.
- She selects Show incomplete accounts. The Incomplete view lists only those 38.
- She works down the list using the Add industry, Add phone and Assign buttons in the empty cells, without opening each account.
- For accounts with no owner, she ticks several rows and uses Assign owner on the bulk bar.
- She sets Rows per page to 100 to finish the rest in one pass. When the banner disappears, every account can be sorted and filtered by industry and phone.
A sales manager's Monday review
- On CRM Home she sets Compare with to Last 7 days and checks the four tiles.
- Under Needs attention she selects Assign beside unassigned leads and gives each one an owner from the bulk bar.
- She selects Review beside the going-cold row and messages the owners of leads that have gone quiet.
- On the Pipeline board she sorts cards by Days in stage to find deals nobody has touched, then switches to Table to read submission deadlines in one column.
- On Reports she reads the currency note under the period control before quoting the forecast, then checks Stalled deals for anything quiet for three weeks or more.
An office administrator cleans up after a trade show
- Fifty business cards became leads through the event's lead form. Some visitors left only a company name, so their rows show the company or email instead of a person's name.
- She opens the New this week view, filters by the trade show Source, and assigns owners in bulk.
- Two visitors turn out to be existing customers. Rather than convert them, she deletes the duplicate leads. A lead with nothing logged against it is removed outright; one with any history is archived instead.
- A third was a contact deleted last year. She finds the person under Archived on the Contacts list and selects Restore, keeping their history.
Ten minutes on the Unassigned and Going cold views each morning keeps the Monday review short. The views are deep links, so bookmark them.
Worked examples: from bid to signed contract
These walk-throughs string the record screens together in the order real work happens. The names are made up; the buttons are real.
A public tender: roof replacement for a school district
Your estimating team is bidding a roof replacement posted on a provincial tender portal. The submission deadline is in three weeks.
- Open the opportunity and go to Pricing › Budget lines. Accept the banner Start from the “Roofing” template? to load your standard breakdown.
- Fill quantities and unit costs on the lowest lines — tear-off, membrane, insulation, flashing, crane — and mark the crane line Subcontract with its contractor.
- Go to Vendor prices › New price request. Pick the membrane and insulation lines, send to three suppliers by Secure link with View only (can't download), and write the PIN down when Tansi shows it.
- When prices arrive, open Compare and choose, select Choose per item, watch for Ends before the bid is due, and select Use these prices.
- On Bid costs, add the printing and courier costs with receipts and set a Bid budget. Leave the Bid costs line Charge to client off if the tender forbids pursuit costs in the price.
- On Price sheet, choose Section totals, set the tax rate, check the real margin, and select Create price sheet. Preview it with the Government price form layout and download the PDF.
- On Submission, apply your tender submission template, assign owners to each part and attach the documents. Log the two addenda the buyer issues; one changes quantities, so create Revision 2 and confirm the Price checked column updates.
- When Ready to submit? reads Everything is ticked., upload to the portal, then Record the submission with the portal's confirmation number and receipt.
- Six weeks later the district awards you the job: mark the deal Won, enter the contract number and awarded value, and attach the signed contract.
- On Contract & billing, add milestones of 30 %, 60 % and 10 % and check that Difference reads The schedule matches the contract value.
An events supplier: audio-visual for a three-day conference
An events company asks you for an AV package with optional extras.
- Build budget lines for speakers, screens, technicians (3 technicians × 3 days using Qty and Qty 2) and setup, with start and end dates so the Timeline view shows load-in and teardown.
- On Price sheet, include everything but mark the livestream line Optional so the client sees it priced separately below the total.
- Pick Every line, by section, preview with the Modern layout, set Prices valid for (days) to 14, paste your own terms, and choose Both under How the client accepts.
- Select Send as quote, tick the event planner and the venue manager under To, and send.
- Turn the client portal on from Client access, invite the planner as a Signer, and share the floor-plan document and the quote.
- When the planner accepts online, create the contract from Contracts › New contract with the planner at order 1 and your director at order 2, and select Send.
- Use Signers to see 1 of 2 signed, and Copy link if your director cannot find the email.
The Pricing sub-tab chips — 3 to price, 2 need vendor prices, Changed since Rev 1 — are a to-do list. Work left to right until they read Done, Chosen and Rev n.
Worked examples: service work, retainers and supply contracts
An office consultancy: billing a monthly retainer
A small consultancy bills a client for advisory hours each month.
- On the client's account, open Team and select Add worker for each consultant with their Hourly rate. Fix any No rate set rows before work starts.
- Consultants log their hours with Track time or Log time; billable Tansi Meet calls add Meeting entries on their own.
- At month end, open Billing, pick the Billing month, check Missing rates is zero, and export Account Billing for your bookkeeper.
- Pin a note — Invoices to accounts payable, PO required — so it shows in Key notes for everyone.
A medical-supply distributor: a clinic network contract
This example is from health care, but nothing here is specific to it — the same steps fit any supply contract, from office furniture to warehouse racking.
- The opportunity is won; on Contract & billing, the Contract value line reads From the award recorded when the opportunity was won.
- Add four quarterly milestones as fixed amounts and tie the first to the submitted price sheet revision.
- When a quarter's deliveries are complete, edit that milestone to Ready to invoice, then select Create invoice and send it from Invoices.
- Attach the clinic network's onboarding form from Forms with Requires approval on, so a manager signs off the completed form.
A warehouse operator: coordinating a 3PL onboarding
A logistics company is onboarding a new third-party-logistics client.
- On the opportunity, add platform tasks from Activity › Tasks — site walk, rate card, insurance certificate — so they land in each assignee's My Tasks and calendar.
- Open the Schedule sub-tab to see the tasks as bars against Bid due.
- Use Notify to ping the operations manager about the client's dock-hours question; it is logged on the timeline as a Notification.
- Book the site walk with Meeting › Schedule meeting, pick the client's time zone, and attach the site map.
- After the walk, log the call outcome with Log a call, tick Also log the call's length as time, and add photos to Documents — keeping the internal rate sheet Private.
Before you turn on the portal for any of these clients, open See what they see. If the list holds something internal, flip its chip back to Internal only first.
Working in French or Spanish
The whole CRM is trilingual — English, French and Spanish — and that includes every public page, not only the pages your staff use. Labels, helper text, empty states, error messages and confirmations are all translated.
Inside Tansi
Your interface language follows your own profile setting. Changing it changes every CRM screen: the lists, the record tabs, the dialogs, the settings panels. The data does not change — a lead's name and a note's text are what somebody typed.
Contacts and leads carry a Preferred language of their own, separate from yours. It is one of the detail fields on the contact panel, and it is what Tansi uses when it sends them something.
On the contact and lead forms the field is labeled Preferred language, with the helper Emails and messages to this contact are sent in this language. The record page shows it as Preferred language: Français, or Not set.
Pages your clients see
Every public CRM page renders in a branded shell with a Tansi logo, a public footer and a language switcher. That covers the lead form, the client portal, quotes, invoices, contract and proposal signing, shared table rows, unsubscribe, poll answers, the vendor pages and the event pages.
A link in an email can set the language before the page opens, using a ?lang= parameter on the URL. CRM documents and campaign emails are sent in the recipient's language, so a French-speaking client gets a French quote and a French page to accept it on.
The lead form has its own Form language setting in the share and embed panel, so an embedded form on a French page can open in French regardless of who set it up.
Anything you type yourself — a lead form question, an intro sentence, a thank-you message — is yours to translate. The lead form editor will not let you save a question with no text in any language, which is a floor, not a target. If you serve clients in French, write the French.
Every page in this module
Two tables. The first lists the pages you reach while signed in. The second lists the public pages — the ones your clients, vendors, visitors and attendees open from a link, with no Tansi account.
Pages you reach signed in
| Route | Page and what it is for |
|---|---|
| /crm | CRM Home — the overview: key figures, charts, what needs attention and your open tasks. |
| /crm/accounts | Accounts list — the companies you do business with. |
| /crm/accounts/{id} | Account record — one company, with its contacts, opportunities, projects, team, billing and history. |
| /crm/contacts | Contacts list — the people at those companies. |
| /crm/contacts/{id} | Contact record — one person, with their timeline, messages and communication preferences. |
| /crm/leads | Leads list — new interest, with saved views. Deep-linkable with ?view=. |
| /crm/leads/{id} | Lead record — the progress path, next action and conversion. |
| /crm/leads/forms | Lead Forms list — every public form, with its status, recent submissions and which one is the default. |
| /crm/leads/forms/{formId} | Lead Form editor — fields, routing, questions, sharing, wording and preview for one form. |
| /crm/leads/form | Lead Form editor — the legacy single-form route, kept working. |
| /crm/opportunities | Opportunities list — deals, sorted by submission deadline. |
| /crm/opportunities/{id} | Opportunity record — the bid workspace. Tabs are deep-linked with a # hash. |
| /crm/pipeline | Pipeline board — open deals as stage columns you can drag between. |
| /crm/activities | My Activities — your open follow-ups and tasks in due buckets. |
| /crm/projects/{id} | Project record — what a won opportunity becomes. Reached from the opportunity or the account, not from the navigation. |
| /crm/events | Events list — every event with its registrations, capacity and revenue. |
| /crm/events/{id} | Event record — agenda, passes, registrations, orders, feedback, and networking and sponsors where enabled. |
| /crm/events/{id}/check-in | Event check-in — the phone-first door page. |
| /crm/events/spaces | Spaces & calendar — the rooms you book across events, and the booking calendar. |
| /crm/procurement-portals | Procurement Portals — the tender sites you bid on. |
| /crm/reports | Sales reports — pipeline, forecast, activity, win and loss reasons, and performance by owner. |
| /crm/settings | CRM Settings — opens on Pipeline stages. |
| /crm/settings/{section} | CRM Settings section — one panel, with its own URL and legacy aliases. |
| /crm/admin | CRM Settings — the legacy route, with ?tab= aliases. |
| /crm/admin/accounts | Chart of Accounts — the codes quote, invoice and cost lines are coded against. |
| /crm/campaigns | Campaigns — covered in Module 04, Mass Communication. |
Public pages, opened from a link
| Route | Who opens it and what they see |
|---|---|
| /crm/lead-form/{token} | Public lead form — a visitor fills it in and becomes a lead. |
| /crm/portal/{token} | Client portal — a client sees the quotes, invoices, documents, notes and tasks you shared, and can send things back. |
| /crm/quotes/view/{token} | Quote / estimate — the client reviews it and accepts or declines. |
| /crm/invoices/view/{token} | Invoice — read-only, with attachments and a download. |
| /crm/contracts/sign/{token} | Sign contract — a party signs in turn by typing their full legal name. |
| /crm/proposals/sign/{token} | Sign proposal — the same, with line items, totals and terms. |
| /crm/table/{token} | Shared table rows — a read-only table of the columns you shared, with an Excel or PDF download. Always expires. |
| /crm/unsubscribe/{token} | Unsubscribe — a recipient opts out, and the date and source are recorded. |
| /crm/poll/{token}/{blockId} | Email poll answer — confirms the option clicked in an email and shows the running result. |
| /crm/vendor-request/{token} | Vendor price request — a vendor's private page for one request: documents, items and questions. |
| /vendor-portal | Vendor portal — passwordless sign-in by emailed link. |
| /vendor-portal/link/{token} | Vendor sign-in link — works once, for twenty minutes. |
| /events/{slug} | Event page — dates, venue, agenda, passes, promo codes and the sponsor wall. |
| /events/{slug}/register | Event registration — buyer details, one block per attendee, questions, order summary and consent boxes. |
| /events/{slug}/confirmed | Registration confirmation — ticket download, calendar link and payment state. |
| /events/manage/{token} | Manage my registration — the attendee's self-service page for payment, portal links and cancellation. |
| /events/portal/{token} | Attendee event portal — ticket and QR code, agenda, meetings, directory, exhibitors, profile, feedback and recordings. |
| /events/scan/{token} | Exhibitor lead scanner — a booth rep's phone page for scanning badges, with consent-filtered exports. |
Public pages are reached by token, with no sign-in. Portal and attendee links are personal and say so on the page. Shared table links always expire. Vendor sign-in links work once. Treat a token in an email the way you would treat a key, and reissue rather than forward.
CRM Settings addresses
| Address | Panel (older names that still work) |
|---|---|
| /crm/settings/chart-of-accounts | Chart of accounts (financial, accounts) |
| /crm/settings/units | Units of measure (uom) |
| /crm/settings/pricing-templates | Pricing templates (templates) |
| /crm/settings/submission-templates | Submission templates (submission, checklists) |
| /crm/settings/document-formats | Quote and price sheet formats (formats, quote-formats) |
| /crm/settings/vendor-request-templates | Vendor request templates (vendor-templates, vreq) |
| /crm/settings/vendors | Vendors and contractors (contractors, vendors-and-contractors) |
| /crm/settings/custom-fields | Custom fields (fields) |
| /crm/settings/pipeline-stages | Pipeline stages (stages) — the default panel |
| /crm/settings/picklists | Picklists; add ?field=LossReason to open one list |
| /crm/settings/tags | Tags |
| /crm/settings/leads | Leads |
| /crm/settings/calling | Calling |
CRM Campaigns
Email and SMS sent to many people at once from your CRM — who receives it, what it says, when it goes, and what came back.
Before you start
A campaign is one email or one text message sent to many people at once, with a record afterward of who received it and what they did with it. This module covers the campaigns that draw their audience out of your CRM: leads, contacts, a company's people, a tag, or the attendees of an event.
It is written for the person who presses Send. You do not need to be technical. You do need to be comfortable being accountable for what goes out, because several of the steps in here cannot be taken back.
What you need to get in
Campaigns live under Sales & Clients › Campaigns. Two permissions have to be in place at once: the CRM module above None, and the CRM administration feature above None. That second one is the same feature that controls CRM Settings and the Chart of Accounts, so if you can reach those, you can reach campaigns.
If one of them is missing, the page loads and shows a red alert reading You don't have access to CRM Campaigns. Nothing on the page works. Ask whoever manages permissions in your workspace rather than trying another route — the same check runs again on the campaign report page.
Three things a campaign cannot be sent without
- A mailing address on your workspace. Every campaign email prints your organization's postal address in its footer, because the law requires it. Without one, step 3 of the editor replaces everything with a red alert and the Send button stays disabled. Even a test send is refused.
- An audience that resolves to at least one person. Tansi re-checks this at the moment you press Send, not when you build the list.
- For a text campaign, a workspace phone number. Without one the SMS channel is disabled in the editor, with help text explaining why.
What applies to you, and what applies to an administrator
Almost all of this module is ordinary day-to-day work: build an audience, write the email, test it, send it, read the report. The parts that need an administrator are the mailing address, the workspace phone number, permissions, and the workspace-wide suppression list described in the consent section.
A Developer working in View-All with no acting workspace picked cannot do anything here. The New campaign button is disabled, the editor refuses to open from a row menu, and a preview fails with Pick a tenant before creating a campaign. Pick a workspace in the picker above the grid first.
A campaign belongs to exactly one workspace, and the draft remembers which. If you open a draft that belongs to another workspace, the mailing address, the default From name and the texting check all come from that workspace — not the one you are browsing. Check the From name on step 3 before you send.
Glossary
Campaigns borrow vocabulary from email marketing, from your CRM and from Canadian anti-spam law all at once. Read this once now; you will not need to memorize it.
| Term | What it means |
|---|---|
| Campaign | One email or one text message, its audience, its schedule and its results, stored as a single record. |
| Channel | Email or SMS. A campaign is one or the other, chosen on step 1, and cannot be both. |
| Origin | Whether the campaign was created in CRM Campaigns or in Mass Communication. It is stamped once, at creation, and shows as a chip under the campaign's name. |
| Audience | The rule that decides who receives the campaign — for example all leads with the status New — rather than the people themselves. |
| Record type | Which kind of CRM audience you are building: Leads, Contacts, Event attendees, or Specific companies, people or tags. |
| Selection | The Specific companies, people or tags record type. It is the only audience that can be combined with subscriber lists, Tansi users and pasted addresses. |
| Recipient | One person on one campaign, stored as a row of its own once the campaign is queued. This is what the report counts. |
| Snapshot | The list of recipients written out at the moment you press Send. From then on the campaign sends to the snapshot, not to your audience rule. |
| Subscriber list | A mailing list people sign themselves up to. Lists belong to Mass Communication but can be combined into a CRM Selection audience. |
| Subscriber-only contact | A contact record that exists only because somebody subscribed or because their address was pasted into a campaign. They are deliberately left out of the broad Contacts audience. |
| Suppression list | A workspace-wide block list of email addresses. One row per address and reason: unsubscribed, hard bounce, or spam complaint. Email only. |
| Do not email / Do not text | A flag on one lead or contact that stops campaigns on that channel reaching that person. |
| Consent source | How a person's consent last changed — staff, an unsubscribe link, a lead conversion, a public form, or an import. Stored with the date and, where there was one, the staff member responsible. |
| Staff notice | An operational email to your own Tansi users only. It carries no unsubscribe link and reaches staff who have unsubscribed from newsletters. |
| Merge token | A placeholder in your text that is filled in per person. There are exactly three: {FirstName}, {LastName}, {CompanyName}. |
| Block | One piece of the email — a heading, a picture, a button. An email is a stack of blocks. |
| Canvas | The editor where you build and arrange blocks, with the email drawn as it will be sent. |
| Starter layout | One of three skeleton designs that ship with Tansi: Newsletter, Announcement, Promotion. |
| Template | A design you saved for re-use. Templates belong to the workspace, not to a section. |
| Asset | An image or a file uploaded to the campaign library and used inside a block. |
| Tracking token | A random code issued per email recipient. It is what the open pixel, the link redirect, the poll and the unsubscribe page recognize. Text recipients get none. |
| Open rate | Opens divided by delivered recipients. |
| Click rate | Clicks divided by delivered recipients. |
| Hard bounce | A permanent delivery failure. The address is added to the suppression list. |
| Soft bounce | A temporary failure such as a full mailbox or a busy server. Nobody is suppressed and the mail may still arrive. |
| Complaint | A recipient marked the email as spam. The address is suppressed. |
| Sweep | The background job that picks up queued campaigns and sends them. It runs once a minute. |
| Queued | Handed over to the sweep. The audience is already frozen at this point. |
| Scheduled | How the screen describes a queued campaign whose send time is still in the future. It is not a stored status of its own. |
| Archived | Hidden from the list. It is a flag, not a status, and it changes nothing about a send that already happened. |
| CASL | Canada's Anti-Spam Legislation. It governs consent, sender identification and unsubscribe for commercial electronic messages. |
| Double opt-in | A per-list setting where a signup is only confirmed after the person clicks a link in a confirmation email. |
| Poll | A one-question block inside the email. Each answer is a link, and the results appear on the campaign report. |
Which Campaigns am I in?
Tansi has two menu entries that both say Campaigns. This causes more confusion than anything else in the module, so it is worth getting straight before you build anything.
There is one engine behind two doors. The same editor, the same canvas, the same report, the same database and the same sending job serve both. What differs is three things: which menu you came in by, which permission let you in, and which audience sources the editor offers you.
The two doors
| CRM Campaigns | Mass Communication Campaigns | |
|---|---|---|
| Where it lives | Sales & Clients › Campaigns | Mass Communication › Send › Campaigns |
| Address | /crm/campaigns | /comms/campaigns |
| What lets you in | The CRM administration feature | Mass communication access |
| Audience sources it adds | Leads, contacts, companies, tags, event registrants | Subscriber lists, pasted addresses, Tansi users |
| Channels | Email and SMS | Email in practice — texting is a CRM audience feature |
| Origin chip on the row | CRM | Mass Communication |
Both lists show every campaign in the workspace
This is the part that surprises people. Neither list filters by origin. A campaign created in Mass Communication appears in the CRM list as well, and the other way around. The origin chip under the name is how you tell them apart; it is not a filter.
The chip is stamped once, when the campaign is created, and a later edit never moves it. A campaign created in CRM Campaigns and then edited from Mass Communication still reads CRM.
What you see depends on your permissions, not on the door
The audience sections the editor offers are decided by what you are allowed to reach, not by which page you clicked New campaign on. Someone who holds both CRM administration and mass communication access gets every audience source on either page. Someone with only one of them gets only that one, on either page.
That also means the headings above the audience sections only appear when you hold more than the CRM source. If CRM records are all you can reach, the section is unlabeled because there is nothing to tell it apart from.
Campaigns you can see but not touch
If a campaign reaches CRM people — leads or contacts who did not come in through a subscriber list — and you do not hold the CRM source, Tansi shows it to you read-only. You get the headline rates and nothing else: no recipient list, no row menu, no edit, no send, no archive. The Audience column reads Includes records you don't have access to.
This is deliberate. The aggregate numbers tell you how the workspace's mail is performing without exposing the identities of people in a part of the CRM you were not given.
Use CRM Campaigns when the audience comes out of the CRM — leads, contacts, a company's people, a tag, event attendees — or when you need to send a text message. Use Mass Communication when the audience is a subscriber list, a block of pasted addresses, or your own Tansi users. The editor and the report are identical either way.
The campaign list
/crm/campaigns is the home of the module. The header reads Campaigns with the subtitle Mass email & SMS to your leads and contacts. There is one action button, New campaign.
When there is nothing to show yet, the table reads No campaigns yet and invites you to click New campaign to create one.
Narrowing the list
| Control | What it does |
|---|---|
| Search box | Placeholder Search name or subject…. It waits a moment after you stop typing, then searches the campaign name and the email subject together on the server. A partial word is enough. |
| Channel | Email or SMS. Clearable. |
| Status | Any one of the six stored statuses. Clearable. Note that there is no Scheduled option — a scheduled campaign is stored as Queued. |
| Created | A date range on the creation date. The end day is included in full. |
| Show archived | Off by default. Turn it on to bring archived campaigns back into view. |
| Export menu | Top right of the table. Exports the rows listed, with Name, Created in, Channel, Status, Audience, Recipients, Open rate (%), Click rate (%), Sent, Sent by and Created. |
Reading a row
| Column | What it tells you |
|---|---|
| Name | A link straight to the campaign's report. A text campaign carries an SMS icon. Underneath sit the origin chip and, where it applies, an Archived chip. |
| Status | A colored chip. A queued campaign with a future send time reads Scheduled here, even though Queued is what is stored. |
| Audience | A plain-language summary built from the saved rule, such as Leads · 1,240, or Selected companies, people or tags, plus any subscriber lists and Tansi users. It reads Includes records you don't have access to when part of the audience is outside your permissions. |
| Opens | The open rate with a small bar. A dash when nothing has been delivered. |
| Clicks | The click rate, the same way. |
| Sent | The scheduled date and time for a scheduled campaign, otherwise the date it was queued, otherwise a dash. |
| Sent by | Whoever created the campaign. |
| Actions | The ⋮ menu. It is hidden entirely on a read-only row. |
The rates for the whole page are fetched in one query rather than row by row, so a long list does not get slower because of them.
The whole row is clickable and opens the campaign's report; the name is also a link you can reach with Tab. The Sent column shows a date and time for a scheduled campaign, and only the date for one that has been queued. The Audience text ends with the recipient count once there is one, for example Leads · 1,240 or 2 subscriber lists, Tansi users · 310.
The row menu
Which items appear depends on where the campaign is in its life.
| Item | When it appears |
|---|---|
| Open | Always. |
| Edit / send | Drafts only. Re-opens the editor on the saved draft. |
| Delete draft | Drafts only. |
| Cancel scheduled send | Only while the campaign is queued with a send time still in the future. |
| Duplicate | Any campaign except a draft, as long as a workspace is in context. Opens a copy in the editor. |
| Retry failed (n) | Only when at least one recipient failed. |
| Resend… | Only once the campaign has finished — sent, partially sent, or failed. |
| Archive | Only on a campaign that is not a draft and is not queued or sending. A draft can only be deleted. |
| Restore | Only on an archived row. |
On a draft the menu offers only Open, Edit / send and Delete draft. A draft cannot be duplicated or archived. Restore on an archived campaign happens straight away, without a confirmation, and shows Campaign restored.
What each confirmation actually promises
| Action | What the dialog says, and what happens |
|---|---|
| Archive | Archive campaign — the campaign will be hidden from the list and can be restored with Show archived. You then see Campaign archived. |
| Delete draft | Delete draft — the draft will be permanently deleted and this can't be undone. You then see Draft deleted. |
| Cancel schedule | Cancel scheduled send — the campaign won't send and goes back to a draft you can edit or re-schedule. The buttons read Cancel send and Keep schedule. |
| Retry failed | Retry failed sends — this queues a new campaign and sends to those recipients again, and it can't be undone. Tansi then takes you to the new campaign. |
Deleting a draft removes it outright. There is no restore, no archive, no undo. Every other campaign in Tansi can only be archived, which hides it from the list and nothing more. A draft cannot be archived, so if you are not certain, keep the draft instead of deleting it.
The archived flag is exactly what hides a campaign from the sending job. Archiving mid-flight would quietly cancel the send, and restoring it later would quietly release a stale audience. So Tansi refuses: This campaign is queued — wait for the send to finish before archiving it. The menu item is hidden, but the real check is on the server, so there is no way around it.
Archiving also does not rewrite history. An archived campaign still appears in each person's campaign history and still counts in reporting. The send happened; archiving only tidies your list.
When something goes wrong, you get one of three messages: you are not allowed to do that; This campaign changed since the list loaded…, which means somebody else moved it on and you should refresh; or a general error.
The unsaved-work banner
If you closed the editor without saving, a banner sits between the toolbar and the table: You have an unsaved campaign “{name}” from {time}. with Resume and Discard. The copy lives in your own browser, so it follows the computer rather than the account.
The banner only ever offers the newest copy. If you abandoned two editors, pressing Discard reveals the next one. A copy whose draft has since been sent or deleted is cleared quietly and never offered.
Creating a campaign: the three-step editor
New campaign opens one dialog that holds all three steps. Below about 1020 pixels wide it goes full screen. Clicking the backdrop does not close it, and neither does Esc — the only way out is the footer, which is deliberate given what is at stake.
The three steps are 1 Audience, 2 Compose and 3 Review & send. The step bar at the top is clickable: you can jump back to any step at any time. Jumping forward checks the steps in between: an empty specific selection keeps you on step 1, and step 3 needs a valid step 2. Each step button carries a one-line summary of its own state, so you can see at a glance what is still missing.
The form sits on the left and a permanent Live preview on the right. When you open a block design on step 2 the preview steps aside and the canvas takes the whole body.
Step 1 — Audience
Step 1 decides who receives the campaign and on which channel. It has enough in it to need a section of its own; see Choosing the audience. One rule matters here: a Specific companies, people or tags audience with nothing picked cannot leave step 1.
Step 2 — Compose, field by field
| Field | What to put in it |
|---|---|
| Campaign name | Required, on every campaign. This is the internal name — it appears in your list and in reports, never to a recipient. A blank name autosaves as Untitled campaign. |
| Subject | Required on email. This is the line recipients see in their inbox. |
| Preview text (optional) | Up to 300 characters. The snippet inboxes show after the subject line. It is not visible once the email is opened, so do not repeat the subject there. |
| Message body | Only for text campaigns and for older plain-text campaigns: a single eight-line text area. |
| Start with | On a new email with no design yet, a grid of cards: Blank, the three starter layouts, and every template saved in your workspace. Picking any card opens the canvas. |
Below the message sits the tools row. It holds the three merge-token chips — {FirstName}, {LastName}, {CompanyName} — which insert at the cursor of whichever field you last used — in canvas mode only the subject, because inside the email you use Insert field. In canvas mode it also gains a Template name box, a Save as template button and a red Start over.
To leave step 2 you need a name; on email you also need a subject and, on a block design, at least one block — otherwise you are told to Add at least one block to the email.
Step 3 — Review & send, field by field
Entering step 3 triggers a live recount of the audience. While it runs you see Counting recipients…. You may instead see a warning that the count couldn't be worked out and will be checked again when you press Send, or a blunt statement that the campaign would reach nobody.
| Field | What to put in it |
|---|---|
| Summary table | Read-only: campaign name, channel, audience and subject, as they stand. |
| From name | Up to 150 characters. Shown as the sender in inboxes. Leave it blank to use your organization's name — the placeholder shows what that would be. |
| Reply-to email | Up to 256 characters, validated. Where replies land. Use a mailbox somebody actually reads. |
| Test email address | Email with a block design only. Pre-filled with your own address. See Test sends and previewing. |
| Send now / Schedule for later | A pair of radio buttons. Later reveals Send date and Send time. |
If your workspace has no mailing address, step 3 replaces all of that with a red alert: Add your organization's mailing address before sending — every campaign email shows it in the footer. Ask a Tansi administrator to add it to your organization's details. The Send button stays disabled until it is fixed.
The footer of the dialog
Left to right: Cancel, the autosave status, Save as draft or Save draft, Back and Next. On step 3 the last button becomes Send campaign or Schedule campaign, and reads Working… while it is busy.
Save draft (or Save as draft) saves the campaign, shows Draft saved and closes the dialog. Reopen it with Edit / send on the list. It needs a name first: Give the draft a name first.
A brand-new campaign starts with From name filled in with your organization's name and Reply-to email with your own address. A draft or a duplicate keeps whatever was saved with it. The Test email address starts as the address you sign in with.
Each step button carries a short summary: step 1 the audience, channel and count (Leads · Email · 1,240 will receive), step 2 the name (or Not named yet) and the number of blocks, step 3 Send now or Schedule for later.
Autosave, and what happens if your browser dies
The editor saves your draft every 60 seconds. The first save creates one draft row and every later save updates that same row — you never end up with a pile of near-identical drafts. When you eventually send, it is that same draft that is queued.
Separately, a copy of your work is kept in your own browser. That is what feeds the resume banner on the list page if the editor is closed without saving.
Cancel asks before discarding. On a brand-new campaign it asks Discard your changes?. Once a draft exists it is gentler: closing the editor loses only the changes made since the last automatic save, and the draft keeps everything before that.
There is no need to press Save draft every few minutes. Pressing it saves the draft and closes the editor, so press it when you are done for now and about to step away — that way the saved draft is a point you chose, not a point the clock chose.
The canvas editor
Picking any card under Start with — Blank, a starter layout or a saved template — switches step 2 into canvas mode. The preview pane steps aside and the email fills the dialog.
The canvas draws your email using the same style rules the sender uses, so what you see is genuinely what goes out. That includes the logo band at the top, when Show logo is on and a logo has been set, and the footer at the bottom. The footer is drawn but never editable; a note underneath says Added to every email automatically. Not editable.
An empty canvas reads This email is empty / Add a first block to start. with a + button.
The top bar
| Control | What it does |
|---|---|
| Undo | Ctrl+Z. Steps back through your changes. |
| Redo | Ctrl+Y, or Ctrl+Shift+Z. |
| Templates ▾ | A Starter layouts group, then Saved templates. |
| Desktop / Mobile | Changes the width the canvas is drawn at, so you can see how the design reflows on a phone. |
| Sample data | Fills the merge chips with Alex, Morgan and Acme Inc. so you can judge the line length. Display only — it changes nothing that is stored or sent. |
Starting from a layout or a template
Three starter layouts ship with Tansi. Newsletter is a monthly-update skeleton: a heading, two update blocks and a link. Announcement and Promotion are the other two. Each one seeds a {FirstName} greeting for you.
Applying a template over a design you have already started asks first: Replace this design? — the template replaces everything in the email, and you can bring your design back with Undo. The whole replacement counts as a single undo step.
Templates are saved per workspace, not per section. A template you save from a CRM campaign turns up in Mass Communication › Setup › Campaign Templates too. Deleting it there does not disturb campaigns already built from it.
Moving around with the keyboard
The canvas states its own keyboard rules on screen: Enter edits the block, Esc stops editing, Alt+Up or Alt+Down moves it, Delete removes it, / adds a block after it, and Ctrl+Z undoes.
At the edge of a Columns block, Alt plus an arrow moves the block into the neighboring column, or out of the columns entirely. That is the keyboard equivalent of dragging between columns.
Every block also has its own small toolbar: a drag handle, Move up, Move down, Duplicate and Delete. Each action announces itself for screen readers, for example Heading deleted — Ctrl+Z to undo or Image moved to column 2, position 1 of 3.
Editing text in place
Text, headings and button labels are edited directly on the canvas rather than in a side field. A floating format bar appears over whatever you are editing: B, I, and Link with its own https:// field and Apply / Remove link. Text, heading and button-label regions also get Insert field ▾ for the three merge tokens.
Merge tokens appear as little chips you cannot type inside, and are turned back into {FirstName}-style text when the design is saved. Typing is sent to the server shortly after you stop, and everything in flight is flushed before any step change, save or send, so nothing is lost by moving on quickly.
Pasting is cleaned up. Paragraphs, line breaks, bold, italic, underline, links and lists survive. Headings and blockquotes become paragraphs. Scripts, embedded frames and the like are dropped with their contents. Anything else keeps its words and loses its formatting. In a single-line region such as a heading or a button label, a paste collapses onto one line and Enter does nothing.
The tidy-up in the browser is cosmetic. Tansi runs the same allow-list again on the server and then passes the result through its sanitizer, and links are limited to http, https and mailto. Pasted content cannot smuggle anything executable into an email, whatever the source document contained.
Merge tokens: there are three, and only three
{FirstName}, {LastName} and {CompanyName} are the entire set. Any other word in braces is replaced with nothing at all, silently — Dear {Salutation} sends as Dear. Use the chips rather than typing the braces by hand.
For a Tansi user recipient, the company comes from their active employee record in the campaign's workspace, and is blank if they do not have one.
Undo, redo and Start over
The canvas keeps up to 100 snapshots, dropping the oldest first. A burst of typing, or a run of panel tweaks of the same kind within about a second, collapses into one undo step so that undoing feels like undoing a change rather than a keystroke. Making a new change clears the redo trail.
One history is shared by the canvas and the settings panel and is owned by the editor, which means undo survives moving between steps. Go to step 3, come back, and Ctrl+Z still works.
The red Start over button asks first (Start over? — This clears everything you've built in this email so far. This can't be undone.), then empties the design and shows the Start with cards again. On a draft that has already been saved, that emptiness is itself saved — it is stored as an empty design, not as no design. If it were stored as no design, the old design would reappear the next time the draft was opened.
Older plain-text campaigns
Campaigns created before the block builder existed carry a plain message body instead of a design. Tansi never converts them. Editing one, or duplicating one, keeps the single text area forever. If you want that message as a block design, rebuild it from a starter layout.
What empty blocks look like
| On the canvas | Means |
|---|---|
| No image yet — choose one in the side panel | An Image block with no picture. |
| No file yet — choose one in the side panel | A File block with no file. |
| Empty HTML block — add its code in the side panel | An HTML block with no code. |
| Empty column | A column with nothing in it; use its +. |
| This block can't be shown here | A block the canvas cannot draw; it is kept. |
| Type a heading / Type text / Button label | Placeholder text while you edit an empty region. |
The side panel's first tab reads Selected block and stays grayed out until you select a block; then it reads Selected: {type}. Alignment choices are Left, Centre and Right. Both Button link (URL) and Image link (URL, optional) must start with http:// or https://, or you see The link must start with http:// or https://.
The ten block types
The Add a block menu offers ten types, always in this order: Heading, Text, Button, Image, Columns, Divider, Spacer, File, Poll, HTML.
| Block | What it is for, and what it starts as | Its own settings |
|---|---|---|
| Heading | A section title. Starts as Your heading, level 2, aligned left. | Heading level (1 largest, 2, 3 smallest) and Alignment. |
| Text | A paragraph. Starts as Write something…. | Text size: Small, Normal or Large. |
| Button | A call to action. Starts labeled Click here, centered, with no link. | Button link (URL), which must begin http or https, and Alignment. |
| Image | A picture. Starts centered with no image and no alt text. | Image (choose or replace through the asset picker), Alt text, Image link (URL, optional) and Alignment. |
| Columns | Two or three side-by-side areas you can drop other blocks into. Starts as 2 empty columns. | Number of columns, 2 or 3. |
| Divider | A horizontal rule between sections. | None — the panel says a divider has no options beyond spacing and background. |
| Spacer | Empty vertical room. Starts at 24 px. | Height, a slider from 4 to 120 px. |
| File | A download link to a file in your asset library. Starts with no label. | File (choose or replace) and Label. |
| Poll | A one-question vote, each answer a link in the email. Starts as Your question with Option 1 and Option 2, results hidden. | Question, Answer options (2 to 6) with add, remove and reorder, and Show results to voters. |
| HTML | Hand-written email markup, for when nothing else fits. Starts empty. | An HTML text area with a live byte counter. |
Settings every block has
Below a dividing rule, each block — whatever its type — gets Spacing above, Spacing below (sliders from 0 to 48 px) and Background colour. Spacing starts at Auto, which writes nothing and lets the block keep its natural breathing room. A Reset to auto button puts it back.
The built-in spacing is tuned to look right in real mail clients. Setting an explicit value on every block is a common way to end up with an email that looks cramped on a phone. Change spacing where you have a reason, and leave the rest on Auto.
Polls, and what to expect back
Each answer in a poll is a link. Clicking one records the vote, sends the recipient to a short thank-you page, and also counts as an open and a click for that person. Re-voting updates the person's answer rather than adding a second one, so nobody is counted twice.
If you turn on Show results to voters, the thank-you page shows the running totals to whoever voted. Leave it off and they only see their own answer.
Styling, columns, HTML and the asset library
Email styles
The second tab of the side panel sets the look of the whole message rather than one block.
| Setting | What it controls |
|---|---|
| Accent colour (buttons) | The button color. |
| Backdrop colour | The area around the email card. |
| Email colour | The card the blocks sit on. |
| Text colour | The body text. |
| Font | Modern sans, Classic serif, or Rounded. |
| Content width | A slider from 480 to 800 px. |
| Show logo | Whether the logo band is drawn above the content. |
Each color field offers a hex box, a swatch, eight presets and a Default or None button to clear it. Only a six-digit hex value is accepted, written with a hash: anything else gives Use a colour like #c8102e (a # and six letters or digits). The error only shows after you leave the field, so a half-typed color is not flagged while you are still typing it.
Older campaigns can hold color values written as words or in other notations. Those still send as they always did, but the panel treats them as invalid, so re-saving one means typing a hex value.
The Email styles tab only offers the Show logo checkbox. Which image is used as the logo is a document setting with no picker here. If the wrong logo appears, or none does with the box ticked, that is not something you can fix from the canvas — ask an administrator.
Columns, and the three things that cannot go inside one
A Columns block holds 2 or 3 columns. You can drag blocks into a column, or move them in with Alt and an arrow key at the edge of one.
Polls, Files and other Columns blocks cannot go inside a column. The + menu inside a column leaves those three out, and a drag or keyboard move that would break the rule is refused with an announcement reading {Type} can't go inside a column. That announcement is made for screen readers; if you are working with a mouse, the block will not land, which can look like the drag failed.
Dropping from 3 columns to 2 moves the third column's blocks into the second. Nothing is lost, but things move, and the panel warns you before you do it.
Images inside a column are capped at the column's width, matching what the sent email does. On a phone the columns stack one above the other.
HTML blocks
An HTML block is for markup you have been given — a supplier's banner, a layout your designer built. The text area carries a live {bytes} / {max} bytes counter and a note that scripts and other unsafe markup are removed when the email is saved and sent.
The limit is 20 KB per HTML block, and it is enforced as you type: the keystroke that would cross the line is rejected with This HTML block is limited to 20 KB. Your last change was not applied. Paste a long block of markup and you may lose the tail of it without noticing.
HTML blocks are cleaned with a wider rule than inline text, because real email markup needs it: tables, images, inline styles and background attributes survive. Scripts, javascript: links and data URLs other than images do not.
The asset library
Images and files used in blocks live in a per-workspace library. The picker opens inline, underneath the block rather than as a second dialog, so you keep your place. It shows a search box, Upload image or Upload file, Cancel, and the existing assets with an extension chip, name, size and the date each was added.
| Rule | Detail |
|---|---|
| Image formats | PNG, JPG, GIF and WEBP. SVG is rejected — mail clients handle it badly and it can carry script. |
| File formats | PDF, DOC, DOCX, XLS, XLSX, TXT and ZIP, plus whatever else your workspace allows as a document. |
| Size caps | Images up to 5 MB, files up to 25 MB. |
| Large images | Anything bigger than 1200 × 1800 is scaled down and re-encoded on upload. GIFs are passed through untouched so animation survives. |
| Delivery | Assets are served to recipients through a long-lived public link, so images load in old email even years later. |
No campaign screen can delete an image or file. If one is ever removed behind the scenes, it only leaves the picker. Emails already sent keep resolving it and keep displaying it, indefinitely. If something must stop being visible, removing it from the library would not be enough.
The reverse is also true: a new campaign cannot use a deleted asset. Saving fails with The design references an image or file that no longer exists. An affected block shows This file is no longer in the library. It still sends as before.
The picker's search box reads Search images or Search files. With nothing uploaded yet it says Nothing uploaded yet — upload one above., and a search with no match says Nothing matches “{text}”. Each entry shows {size} · added {date}. Picking an entry, or finishing an upload, puts it straight into the block. An upload that breaks a rule is refused with a message explaining why.
No campaign screen has a delete button for images or files. Name uploads clearly, because everything you upload stays in the picker for everyone in the workspace.
The limits an email has to stay inside
| Limit | Value |
|---|---|
| Blocks per email | 100, counting blocks nested inside columns. Over that: An email holds at most 100 blocks. |
| Whole design size | 200 KB. Over that: The campaign design is too large. |
| One HTML block | 20 KB. |
| Content width | Clamped to 320–800 px when saved. |
| Spacer height | 4–120 px. Block spacing 0–48 px. |
Some checks only run when you send, not while you design, so that an unfinished draft is never blocked from saving. At send time: a poll needs a question and 2 to 6 options; a button needs an http or https link; an image needs an actual uploaded image; a file block needs a file; an HTML block cannot be empty; and at least one block must carry real content, or you get Add some content before sending.
Choosing the audience
Step 1 is where you say who the campaign is for. You are writing a rule, not picking names — with one exception, the hand-picked people in a Selection. Tansi turns the rule into actual recipients later, at send time.
CRM records
| Field | What it does |
|---|---|
| Record type | Leads, Contacts, Event attendees (only if your workspace has events and you can reach them), or Specific companies, people or tags. |
| Channel | Email or SMS. SMS is disabled, with an explanation, when the workspace has no phone number. |
| Status / Source | On Leads. Multi-selects. Leaving one empty means all — the label says all if none selected. |
| Event / Registration status / Passes (optional) | On Event attendees. Registration status defaults to Confirmed. |
| Companies / Tags / People | On a Selection. Each pick becomes a removable chip. The People box searches live leads and contacts by name, email or company. |
| Account ID (optional) / Owner user ID (optional) | Account ID on Contacts only; Owner user ID on Leads, Contacts and Event attendees. Narrows the audience to one account, or to one owner. |
Account ID and Owner user ID are plain entry fields, not pickers. You have to know the number or the identifier already. If you are not sure what to type, leave them blank and narrow the audience another way — a tag on the account is usually easier to manage than an ID typed from memory.
How each record type resolves
| Record type | Who it actually reaches |
|---|---|
| Leads | Live leads of the workspace that have not been converted, matching your status, source and owner filters. On email, their email address; on SMS, their phone — but only if it is marked as able to receive texts. |
| Contacts | Live contacts, filtered by account and owner. Subscriber-only contacts are deliberately left out — somebody who only ever joined a newsletter is not a contact of your business. |
| Event attendees | Registrations for the chosen event, filtered by registration status and pass type, resolved to the registrant's contact where there is one and their lead otherwise. Subscriber-only contacts are included here, because registering for an event is an explicit act. |
| Selection | Everything you picked, combined: the contacts of picked companies and of tagged companies, tagged leads and tagged contacts, hand-picked people, subscribed members of picked subscriber lists who have a live contact, pasted addresses, and picked Tansi users. |
A hand-picked lead that has since been converted stands in as the contact it became. A pick that was deleted since you made it shows (deleted) on its chip, and a converted lead shows (converted).
Somebody who matches twice receives once. Tansi de-duplicates on the email address, or on the phone digits for a text campaign, preferring a contact over a lead and a lead over a Tansi user. Where the same contact arrives by two routes, the one that came from a subscriber list wins, so the recipient record remembers which list it came from. Everything dropped this way is reported as duplicates removed.
Mixing CRM records with lists and users
Subscriber lists, Tansi users and pasted addresses only live in a Selection. Pick one while you are on Leads, Contacts or Event attendees and Tansi switches the record type for you, saying so: The CRM audience changed to specific companies, people or tags so it can combine with lists and Tansi users. The other record types are then disabled until you remove that pick.
Pasted addresses are an email-only option. Separate them with a vertical bar; commas and new lines also work. Tansi counts what it found, names anything it could not read as an address, and refuses a paste over the cap with a suggestion to import a bigger audience into a list instead.
The helper text says people not in Tansi are saved as subscribers when the campaign is sent — and that is literally when it happens, at queue time, not when you paste. Those people turn into subscriber-only contacts in your CRM. An address that is already opted out anywhere is dropped at that point and is never re-subscribed.
Be aware of the other side of that: a subscriber-only contact is invisible to the broad Contacts audience and to the people search box, but is reachable through their list and through the Event attendees audience. If you cannot find somebody in the picker, that is usually why.
Staff notices
When the audience is Tansi users and nothing else, on email, a switch appears: Staff notice — recipients can't unsubscribe. The help text is exact about what that means: for operational messages to your own staff; no unsubscribe link is added; staff who unsubscribed from newsletters still receive it.
Add any other kind of recipient and the switch disappears. Tansi re-checks the rule on every save and again when you send, refusing with Staff notices can only go to Tansi users. Marketing content must never go out as a staff notice — see the consent section for why.
Preview audience
Preview audience runs the rule and reports back in one line: how many will receive it, how many duplicates were removed, how many were skipped as unsubscribed or bounced, how many had no email address (or no mobile number, on SMS), and how many you removed by hand.
Those counts are an estimate at a moment in time. Any change to the audience clears them. Flipping the staff-notice switch alone changes them, because staff who unsubscribed are counted differently.
Review recipients
Review recipients opens a searchable table of everybody the audience reaches, with columns Name, Email or Phone, and From — which says whether each person arrived as a CRM contact, a Lead, a Tansi user, a named list, or a pasted address. Untick anyone who should not receive it. The header tick box is labeled Send to everyone shown, and Put back {n} removed restores everybody at once. Very large audiences show the first 5,000 rows, saying so.
Exclusions are stored as addresses, not as people. That has two consequences. They survive edits to the audience, and they are re-applied every time the audience is counted and again on the final send — which is what you want. But there is no list anywhere of who you took out; the only sign is the Put back {n} removed button and its number. If that number is not zero and you did not expect it, press the button and start again.
The search box in Review recipients matches name, address, company and list name. A removed person stays in the table, grayed and struck through, so you can tick them back. Hide recipients folds the table away.
Event attendees only appears in Record type when you have access to Events in this workspace — or when you reopen a draft that already uses it.
When the list is frozen
Your draft stores a rule, not a list of people. A draft saved in March and sent in June goes to whoever matches the rule in June — including leads created in the meantime, and not including anyone who has left. The counts you saw while building are an estimate.
At the moment you press Send, Tansi resolves the rule once, drops anyone opted out or without an address, and writes a fixed list of recipients. From then on, the campaign sends to that frozen list. Changing a tag or a subscriber list afterward has no effect on a campaign already queued.
If nothing survives that resolution, the send is refused with No recipients match this audience. The audience is always resolved as the campaign's own workspace, never as whatever an administrator happens to be browsing.
Campaigns reach a person's primary email and primary phone only. Extra addresses or numbers on a record are never campaign recipients, and a primary phone that is not marked as able to receive texts counts the same as having no number at all.
Consent and the three layers of opt-out
Tansi keeps three independent opt-out layers. They are not alternatives to one another and they do not cascade. Every one of them is checked again at send time, after the audience has been resolved. Understanding the difference between them is the most important thing in this module.
Layer 1 — the flag on the person
Each lead and each contact carries two flags of its own: do not email and do not text. They are per person and per channel. An email campaign checks the email flag; a text campaign checks the text flag and whether the number can receive texts at all.
Contacts also record how that consent last changed: the date, the source, and which staff member did it where one was involved. The sources are Staff, Unsubscribe link, Lead conversion, Public form and Import. That trail is your evidence if you are ever asked to show why you believed you had permission.
Layer 2 — the workspace suppression list
The suppression list is one block list for the whole workspace, holding email addresses only. An address is on it for one of three reasons: the person unsubscribed, the address hard-bounced, or somebody reported the message as spam.
Suppression works on the address, not on the record. It applies regardless of which campaign, which audience, or which record the address happens to sit on. It is the layer that protects you from mailing an address that has already told you to stop.
Layer 3 — list membership
Leaving a subscriber list marks that one membership as unsubscribed. It writes nothing to the suppression list and nothing to the person's own flags.
Somebody who left your newsletter list is still reachable by a CRM audience — by Leads, by Contacts, by a tag, by an event. Only Unsubscribe from all emails from {Workspace} on the unsubscribe page sets the person's own do-not-email flag and suppresses their address.
If a person tells you they want nothing further from you, do not rely on them having left a list. Set the do-not-email flag on their record.
Which layer stops what
| Opt-out | Stops | Does not stop |
|---|---|---|
| Do not email on the record | Every email campaign that reaches that lead or contact. | Text campaigns. Mail to a different address held by somebody else. |
| Do not text on the record | Every text campaign to that person. | Email campaigns. |
| Suppression: unsubscribed | Every email campaign to that address, in that workspace. | Text campaigns. Staff notices to Tansi users (see below). |
| Suppression: hard bounce | Every email to that address, including staff notices. | — |
| Suppression: spam complaint | Every email to that address, including staff notices. | — |
| Left a subscriber list | Campaigns sent to that list. | Any CRM audience, any other list, any other campaign. |
Tansi users are different
Your own Tansi users have no per-person opt-out flag. The suppression list is their only opt-out, and it applies by address exactly as it does for anybody else.
Staff notices are the single exception in the whole model. An operational notice to Tansi users ignores a plain unsubscribed suppression row, because an operational message to your own staff is not a commercial message they get to decline. A hard bounce or a spam complaint still blocks everybody, including staff — a dead mailbox is dead whatever the message is about.
A staff notice carries no unsubscribe link and overrides an ordinary unsubscribe. That is lawful for genuinely operational messages to your own staff — a system outage, a policy change, a shift schedule. It is not lawful for anything promotional, and the exemption does not travel: the moment one non-staff recipient is in the audience, Tansi refuses to save or send it as a staff notice.
If you are unsure whether a message is operational, assume it is not, and let the unsubscribe footer be added.
Where consent comes from in the first place
A public sign-up writes an append-only consent record: the exact words shown to the person, where they signed up, the channel, the page address, the culture, and when it was confirmed. The wording is built once on the server so that what was displayed and what was stored are the same text, and it names your organization — with its website, when the workspace has one.
A list can require double opt-in, in which case nothing is confirmed until the person clicks the link in the confirmation email. A pending double opt-in signup has no contact record at all and can never be a campaign recipient.
An imported list is different. A CSV import marks members as subscribed even on a double-opt-in list, which is why the importer must make a consent attestation and why that attestation is recorded. If you are importing a list, you are the one asserting that those people consented.
Nothing in Tansi ever re-subscribes a suppressed address or an unsubscribed membership. Not an import, not a paste, not a re-signup through a form. That is by design: once somebody has said no, only a deliberate act on their record can change it.
Test sends and previewing
The live preview
The preview pane sits beside the form at all times except in canvas mode. It is titled Live preview and carries a Desktop / Phone toggle, a simulated inbox line showing your subject and preview text — reading (no subject yet) when blank — and a switch reading Fill merge tokens with sample data.
The email itself is drawn in a sealed frame, which is why nothing in it is clickable. The footnote says so directly: it is a rendering, not the email itself, and an unsubscribe footer is added to every email.
The preview redraws a moment after you stop typing. If a half-finished design cannot be drawn, the last good preview stays on screen rather than flashing an error. That is worth knowing: a preview that has stopped changing may be stale, not finished.
| The preview says | Because |
|---|---|
| Pick a starting point on step 2 to see the email here. | No design has been started yet. |
| Add a block to see the email here. | The design is started but empty. |
| Write the message on step 2 to see it here. | A text campaign, or an older plain-text email, with no body yet. |
For a text campaign the preview shows the message as a plain bubble, with no Desktop/Phone toggle and no inbox line.
Sending a test
On step 3, an email campaign with a block design gets a Test email address field, pre-filled with your own address, and a Send test email button.
| What a test send does | Detail |
|---|---|
| Subject | Prefixed with [Test] , so you can never confuse one with the real thing. |
| Merge tokens | Always filled with the sample values Alex, Morgan and Acme Inc. — never with a real person's details. |
| Tracking | None at all. No tracking token, no open pixel, and links go to their real destinations rather than through the redirect. |
| Records | Nothing is written. No campaign row, no recipient, no activity on anybody's timeline, nothing in any report. |
| Validation | Looser than a real send, so an unfinished design can still be test-sent. |
| Rate limit | Five test sends per person per ten minutes. Over that: Too many test emails — try again in a few minutes. |
| Mailing address | Still required. A test send is refused without one, the same as a real send. |
Open it on a phone first, because that is where most people will read it. Then check the subject and the preview snippet in the inbox list, before opening. Then click every link, including buttons and file downloads. Then read the footer and confirm the organization name and address are right.
Because a test is untracked, it cannot tell you whether your links will be recorded or whether the poll works. It also uses sample merge values, so it cannot tell you whether a real recipient's name is going to be blank. For that, look at Review recipients and check the names are populated.
Scheduling and sending
Now, or later
Step 3 offers two radio choices. Send now says that Send queues the campaign straight away, after you confirm the recipient count. Once queued it can't be undone. Schedule for later reveals Send date (no earlier than today) and Send time, with the reminder that times are your local time and that a scheduled campaign can be canceled back to a draft until the send starts.
The time you type is your browser's local time. Tansi converts it for storage and echoes the local time back to you in the confirmation. A time in the past is refused: The scheduled send time must be in the future.
The confirmation
Pressing Send campaign or Schedule campaign recounts the audience and then asks you to confirm. For an immediate send it names the subject, the number of people it will reach and the number of people who matched but were left out because they have no address, opted out, unsubscribed or bounced — and it repeats that once queued it can't be undone. The buttons read Send to {n} and Not yet.
A scheduled send asks the same thing with the date and time, and reminds you it can be canceled back to a draft until the send starts. The buttons read Schedule and Not yet.
Then you see either Campaign queued — sending shortly or Campaign scheduled for {when}.
The moment you confirm an immediate send, the campaign is queued, the audience is frozen and the sending job owns it. There is no stop button, no recall and no administrator who can pull it back. Nothing in Tansi will un-send an email.
Only a campaign scheduled for a time still in the future can be canceled. If you want an undo window, schedule the send for fifteen minutes from now instead of sending immediately.
Canceling a scheduled send
Cancel scheduled send appears in the row menu only while the campaign is queued and its send time is still in the future. Confirming it returns the campaign to a draft you can edit or re-schedule, and you see Scheduled send cancelled — campaign is a draft again.
The frozen list of recipients is deleted along with the schedule, and the campaign's recipient count resets to zero. The draft will look as though its audience has been emptied. It has not — the rule is intact, and a new list is resolved the next time you send.
This is deliberate. It is what stops a list of people chosen weeks ago being quietly released later.
What happens between queued and sent
A background job runs once a minute and picks up exactly one queued campaign each time, oldest first. Queue three campaigns at once and the third starts roughly three minutes after the first. A campaign whose scheduled time has not arrived is left alone, and an archived campaign is never picked up at all.
Within one campaign, email goes out in batches of 50 and text messages in batches of 10, with a one-second pause between batches. A twenty-thousand-recipient email is therefore several minutes of sending, not an instant.
Each recipient is checked again as they are reached: somebody who left the list, who is on the suppression list, or whose record has been deleted or opted out since the snapshot is skipped rather than mailed. A delivery failure is recorded against that one recipient with the reason.
A successful send to a lead or a contact writes an email activity onto that person's timeline. A send to a Tansi user writes none.
Who the email appears to come from
The actual sending address is always Tansi's verified platform address — that is what makes the mail deliverable. Your From name changes the name shown in inboxes and your Reply-to email changes where replies land, but neither changes the underlying sending address.
The six things that stop a send
| If this is true | You get |
|---|---|
| Your workspace has no mailing address (email) | Add your organization's mailing address before sending a campaign. |
| Your workspace has no phone number (SMS) | Texting needs a workspace phone number — contact your administrator. |
| No workspace is in context | Pick a tenant before creating a campaign. |
| The audience resolves to nobody | No recipients match this audience. |
| The design has no blocks | The design needs at least one block. |
| The scheduled time is in the past | The scheduled send time must be in the future. |
If the mailing address or the workspace phone number is removed after a campaign is queued, the send does not wait — it fails every pending recipient with No mailing address configured for this organization. or No tenant SMS number configured. and marks the campaign Failed. Do not edit those workspace settings while a campaign is in flight.
Reading the report
Clicking a campaign's name opens its report. The header carries a Back to campaigns link and a subtitle reading Sent {date and time} · From {name}, with chips for the status, the channel, Scheduled for {when} where it applies, and Retry of #{id} linking to the original where the campaign was a retry.
The five cards
Email campaigns show all five. A text campaign shows only Delivered, because there is nothing else to measure.
| Card | How it is calculated | What to watch for |
|---|---|---|
| Delivered | Sent minus hard bounces, over the total. Detail line: {n} of {total}. | Soft bounces are not removed from delivered — a deferred message may well have arrived. |
| Open rate | Opens over delivered. | Always an undercount. Many mail clients block the tracking image. |
| Click rate | Clicks over delivered. | More reliable than opens, because a click is a real action. |
| Unsubscribed | Unsubscribes over delivered. | A sharp rise is the signal to look hard at your audience, not at your subject line. |
| Bounced | Hard plus soft, over sent. Detail line: {n} hard · {n} soft (temporary). | The card's tooltip explains that soft bounces are temporary failures such as a full mailbox, and the email may still have been delivered later. |
Every engagement figure is measured against delivered recipients, so no rate on this page can exceed 100%. Where the denominator is zero, the rate reads zero.
Opens are recorded by a tiny invisible image. Many people never load it, so the open rate is always lower than the truth. A click back-fills an open, which means clicked but never opened can never happen in Tansi. A campaign sent before open tracking existed reports 0% honestly rather than guessing.
Top links
For email campaigns, a table of Link, People and a share bar — one row per tracked link, counting unique people rather than total clicks. Tansi resolves the label from your design, so a button reads by its own label and a file reads by its label or file name. That is why a download shows as Price list rather than as an opaque address. With nothing yet: No link clicks yet.
Opens in the first 48 hours
A simple line chart over 48 hourly buckets, starting from the earliest actual send rather than from when the campaign was created — so a campaign scheduled for next week does not draw itself off the edge of the chart. The accessible summary names the busiest hour and how many opens it carried, or says nothing has been sent yet.
Poll results
Each poll block in the email gets its own section on the report: the question, then each answer as {label} — {votes} ({percent}%) with a bar, and a caption reading {votes} of {sent} responded. Answers with no votes still appear, so you can see what nobody chose.
The responded count counts people, so it can be slightly higher than the sum of the per-answer numbers if an answer option was removed after somebody had already voted for it.
The recipients table
Below everything sits a table of the individual recipients. It is not shown on a draft, and not shown on a report you can only see read-only.
Email campaigns get tabs: All recipients (n), Opened, Clicked, Didn't open, Bounced and Unsubscribed. The columns are Name, the address or phone, Type (Lead, Contact, Subscriber or Tansi user), Status, Sent at, then for email Opened, Clicked, Unsubscribed and Error. Names link straight through to the lead or contact when you have access to them.
Recipient statuses read Delivered, Bounced (hard), Bounced (soft, temporary), Failed, Skipped or Pending. The export menu exports the tab you are currently on, not the whole list.
Message and Details
The Message panel shows the subject, the preview text and the rendered email in a sealed frame, with a Preview with sample data switch. It states that merge tokens are filled with sample values and each recipient received their own, and that an unsubscribe footer identifying the sender is automatically appended to every email.
The Details panel lists who sent it, the audience and all its picks and filters, Recipients as {n} (snapshotted when queued), Failed / skipped, and the created, started and completed times.
Watching a send happen
While a campaign's status is Sending, the report refreshes itself every five seconds and stops when the status changes. A manual Refresh button is also shown during that window.
How opens and clicks are actually recorded
| Signal | How Tansi learns about it |
|---|---|
| Open | A transparent image at the very bottom of the email, below the footer, so a blocked image can never leave a gap above your content. Only the first open is recorded. |
| Click | Every link in the email points at Tansi first, which records the click and then forwards the person on. The destination is looked up from the campaign's own stored list of links, never taken from the address, which is what stops the link being abused. |
| Poll vote | Recorded, then the person is sent to the thank-you page. Voting again replaces the earlier answer rather than adding one. |
| Bounce | Reported back by the mail provider. A permanent failure is a hard bounce and suppresses the address; anything else is soft and suppresses nobody. |
| Spam complaint | Reported back by the mail provider and suppresses the address. |
A click or a poll vote also back-fills the open, on the reasoning that someone who clicked clearly opened the mail even if the image never loaded. A soft bounce never downgrades a hard one. Repeated reports of the same event do not double-count.
One person's campaign history
Every contact and every lead carries a campaign history panel on their own detail page, with columns Campaign, Channel, Outcome and Sent. It reads the recipient records rather than the activity timeline, which matters: skipped and failed recipients write no activity at all, so this panel is the only place they show.
Archived campaigns appear here too, because the send still happened. When there is nothing, the panel says Never included in a campaign, and then either that the person can receive campaigns and should be added through a campaign's audience, or that they have opted out of email and text campaigns so campaigns will skip them. A Go to campaigns link sits underneath.
The buttons along the top
The report header has its own action buttons, the same actions as the list's row menu. They are hidden on a read-only report, except Refresh.
| Button | When it appears | What happens |
|---|---|---|
| Edit / send | Drafts, with a workspace in context | Opens the editor on the draft. |
| Delete draft | Drafts | Asks, deletes, and returns you to the list. |
| Cancel scheduled send | Queued with a future send time | Returns it to a draft. |
| Duplicate | Any non-draft, with a workspace in context | Opens a copy. If you send or save it, you return to the list. |
| Resend… | Finished campaigns | Opens the Resend dialog. |
| Refresh | While sending | Reloads the numbers (they also refresh every five seconds). |
| Retry failed (n) | When something failed | Queues a retry and opens it. |
| Archive / Restore | Non-drafts not queued or sending / archived ones | Archive asks first: "{name}" will be hidden from the campaigns list. You can restore it later. |
Status chips on the report use slightly different words from the list: Completed instead of Sent, Partially completed instead of Partially sent. In Details, Send started shows when the campaign was queued.
Duplicate on the report page does not pass on where you are, so the copy is always stamped with the CRM origin chip, even when you made it from Mass Communication. Duplicate from the list's row menu if the chip matters to you.
Resending, retrying and duplicating
There are three ways to send a campaign's content again, and they behave quite differently. The important shared fact is that none of them edits the original. Each one creates a new campaign.
Resend
Resend… is available only on a campaign that has finished — sent, partially sent or failed. Try it on anything else and you get Only a finished campaign can be resent.
The dialog opens with Resending queues a new campaign with this campaign's content. Who should it go to? and three choices:
- Original recipient list ({n} recipients) — everyone the first campaign reached.
- Non-openers only ({n} recipients) — email only, and disabled when the count is zero.
- Pick a new list (opens a copy in the campaign wizard) — which is the Duplicate flow, described below.
Resend re-targets the stored recipient snapshot. It never re-runs your audience rule, so people who have matched the rule since the original send are not included. The new campaign gets a (resend) suffix on its name and fresh tracking, and anyone who has opted out in the meantime is dropped.
If the original went out before open tracking existed, nobody is recorded as having opened it — so non-openers there means everyone it reached. The dialog says so, but only once you have selected that option.
The dialog's button reads Resend, then Queuing… while it works, or Open wizard when Pick a new list is chosen. You then see Resend queued for {n} recipient(s) and the new campaign opens. For a text campaign whose workspace can no longer send texts, a warning appears and only Pick a new list can be used.
Retry failed
Retry failed (n) appears when at least one recipient failed. It creates a new campaign called {original} (retry) carrying the same content, aimed at exactly the recipients that failed, and queues it immediately. The audience rule is not re-run here either.
Anyone who has opted out since the original is dropped first. If that leaves nobody: Everyone left to send to has since opted out — there is no one to send to.
Duplicate
Duplicate opens a copy of the campaign in the editor as a fresh draft. This is the one that gives you a chance to change the audience, the subject or the design before anything is queued. Use it when you want to run the same message at a different group.
Duplicating gives every block a new internal identity. The practical consequence is that poll votes and any per-block history do not carry over — the copy's poll starts at zero. Editing an existing draft keeps the originals, so this only applies to copies.
Choosing between them
| You want to | Use |
|---|---|
| Send the same message again to the same people | Resend… → Original recipient list |
| Chase the people who did not open it | Resend… → Non-openers only |
| Send the same message to a different audience | Duplicate, then edit step 1 |
| Re-attempt the addresses that failed | Retry failed (n) |
| Change the wording before sending again | Duplicate |
Both create a new campaign that is queued the moment you confirm the dialog. There is no scheduling step, and no second confirmation afterward. Clicking twice can mail the same people twice — the screen guards against a double click, but the underlying service does not. Press once, then wait for the page to take you to the new campaign.
If you want to review before it goes, use Duplicate instead. That opens a draft, which you control.
Unsubscribe and the law
Tansi is built for Canadian senders, and Canada's Anti-Spam Legislation is among the strictest in the world. The parts of this module you cannot change — the footer, the mailing-address requirement, the unsubscribe link — are not product decisions you can negotiate around. They are what keeps your sending lawful.
This describes what Tansi does. It is not legal advice. CASL covers consent, sender identification and unsubscribe, and it applies to commercial electronic messages whether or not anything is being sold directly. If you are unsure whether a particular message or a particular list is covered, ask someone qualified before you send — the penalties fall on your organization, not on the software.
The footer on every campaign email
Three lines are added to the bottom of every campaign email, automatically, and are drawn but not editable in the canvas:
- This email was sent by {Workspace} via Tansi.
- Your organization's postal address, on its own line.
- You received this because you're a contact of {Workspace}, followed by an Unsubscribe link.
The same three lines are repeated in the plain-text version of the email, because some mail clients show only that part and the identification and unsubscribe have to be there too.
Staff notices are the one exception. They keep the sender line and the address but drop the why you got this line and the unsubscribe link entirely, in both versions. See the consent section for when that is appropriate.
No mailing address, no sending
The address is assembled from your organization's details — street, second line, city, province, postal code and country — and counts as missing if both the street and the city are blank. Without it, queueing a campaign, creating one, retrying, resending and even a test send are all refused. In the canvas, the gap shows as the placeholder [Mailing address missing].
This is not Tansi being cautious. Identifying the sender with a physical address is a legal requirement, and an email that cannot carry one cannot lawfully go out.
What the recipient sees when they click Unsubscribe
The link in the footer opens a public page that belongs to the campaign's workspace. It loads on an empty layout with no sign-in.
Nothing happens until the visitor presses a button. This is deliberate: mail security scanners follow every link in an email before the recipient ever sees it, and a page that acted on load would unsubscribe people who never touched it.
The side effect is that somebody can tell you in good faith that they clicked unsubscribe and still be subscribed. Believe them, and set the flag on their record yourself.
The page offers up to two choices, depending on how the person was reached:
| Choice | What it does to the person's record |
|---|---|
| Unsubscribe from these lists | Shown when the recipient came in through subscriber lists. Marks those memberships unsubscribed and stamps the campaign recipient as unsubscribed. Writes no suppression row and does not set the do-not-email flag, so other campaigns still reach them. |
| Unsubscribe from all emails from {Workspace} | Writes an unsubscribed suppression row for the address, sets the do-not-email flag on the contact or lead with the consent source recorded as the unsubscribe link and no staff member attributed, leaves every list in that workspace, and stamps the recipient as unsubscribed. For a Tansi user, the suppression row alone is the opt-out. |
Along the way the page can show: loading, This link isn't valid, You're already unsubscribed, You've been removed from these lists or You're unsubscribed. Everything it does is scoped to the campaign's own workspace, never to whoever happens to be signed in on that computer.
The older unsubscribe link
Some mail sent by Tansi carries an older per-person unsubscribe link, keyed to the person rather than to the campaign. That page behaves differently: it acts immediately on load, with no button. It sets the do-not-email flag, writes the suppression row and stamps the campaign recipient. The wording is Unsubscribed — You've been unsubscribed and won't receive further emails from us.
You will not create new links of this kind — the current footer uses the newer page — but you may see its effects in your records, and an old email in somebody's archive still carries it.
Proof of consent
Every public sign-up writes a permanent, append-only consent record. It keeps the exact sentence that was shown to the person, which channel they signed up through — a link, an embedded form, a lead form or a form built in Forms Studio — the page address they were on, their network address, their language and the confirmation times.
The consent sentence is built once on the server so the wording displayed and the wording stored are the same string, and it names your organization along with its website when the workspace has one. That is what makes the record usable as evidence: you can show exactly what was agreed to, not an approximation of it.
Tansi records consent that arrives through its own forms and honors every opt-out it is told about. It cannot vouch for an audience you built by other means. If you paste a block of addresses, import a spreadsheet, or tag a group of leads and mail them, you are the one asserting that those people consented — and the import attestation is recorded against your name.
Keep that in mind before using the paste box for a list you were handed.
Working in French or Spanish
Tansi ships campaign email text in English, Canadian French and Spanish. What that covers is narrower than people expect, so it is worth being precise.
What Tansi translates
Only Tansi's own words in the email: the footer's three lines, the download label on a file block, and the language marker that tells a mail client which language the message is in. The poll thank-you page also carries the language forward from the email the person clicked.
What Tansi never translates
Your campaign content. Your subject line, your preview text, your headings, your body copy, your button labels and your images are sent exactly as you wrote them, to everybody. There is no automatic translation of a campaign, and no way to hold two language versions of one campaign.
If you need to reach a bilingual audience properly, build two campaigns and split the audience — for example by tag, or by two subscriber lists — so each group gets the version written for it.
How Tansi decides which language to use
Per recipient, in this order: the language set on that person's own record; failing that, whatever a lookup by email address turns up; failing that, English (Canada).
The design is rendered once per language in the audience rather than once per person, which is why a mixed-language audience costs nothing extra in sending time.
There is no language field in the campaign editor, and that is not an omission. The footer language follows the person. If your French-language contacts are getting an English footer, the fix is the preferred language on their contact records.
Worked examples: building and sending a campaign
The sections before this one describe each screen. This one strings them together. Each example lists the exact buttons in the order you press them, and calls out the moment where a mistake would be expensive. Adapt the names to your own business; the steps do not change.
Example 1 — A site-safety open house for general contractors (construction)
A regional builder wants to invite every contractor it works with to a site-safety open house. The contractors are CRM contacts, and their companies carry the tag General contractor. The invitation needs a button to the event page and a quick poll about which session time suits them.
- Open Sales & Clients › Campaigns and select New campaign.
- On step 1, set Record type to Specific companies, people or tags. Under Tags, pick General contractor. Leave Channel on Email.
- Select Preview audience. Read the whole line: how many will receive it, how many duplicates were removed, how many were skipped as unsubscribed or bounced, and how many have no email. A large with no email skipped number means your contact records need work before the next campaign.
- Select Review recipients and untick anyone who should not be invited, such as a contractor you are in a dispute with. The header tick box is Send to everyone shown.
- Select Next. Type the Campaign name (Open house invite — May), the Subject and a short Preview text (optional).
- Under Start with, pick the Announcement starter. The canvas opens.
- Edit the heading and text in place. Select the button block and, in the side panel, paste the event page address into Button link (URL). It must start with https:// or http://.
- Select the + after the text and add a Poll. Set the Question (Which session suits your crew?) and three Answer options.
- Turn on Sample data and switch to Mobile to see how the greeting and the button look on a phone.
- Select Next. On step 3 check the From name (it starts as your organization's name) and set Reply-to email to the site-safety coordinator's mailbox.
- Select Send test email. Open the test on your phone, press the button, and read the footer. Remember a test is untracked, so the poll vote is not counted.
- Choose Schedule for later and set a time fifteen minutes from now. That gives you an undo window.
- Select Schedule campaign, read the confirmation (subject, head count, how many were left out) and press Schedule.
A scheduled campaign can be canceled back to a draft from the row menu until the send starts. Send now cannot be undone once you confirm it. Fifteen minutes is long enough to spot a typo in the subject and short enough not to matter.
Two days later, open the campaign's report. The Poll results section shows each session time with its votes, and Top links shows how many people pressed the button.
Example 2 — A text reminder to confirmed trade-show attendees (events)
An equipment supplier has a booth at a trade show and has run registration through Tansi Events. The day before, it wants to text every confirmed registrant their booth number.
- Check that your workspace has a texting number. If SMS is grayed out on step 1 with help text, ask an administrator; you cannot fix it from the editor.
- Select New campaign. Set Record type to Event attendees. If that choice is missing, you do not have access to Events in this workspace.
- Pick the Event. Leave Registration status on Confirmed. Narrow with Passes (optional) if only exhibitor-pass holders should get it.
- Set Channel to SMS, then select Preview audience. The skipped count now reads with no mobile number skipped. A phone number that is not marked as able to receive texts counts as no number.
- Select Next. Name the campaign and type the Message body. Use the {FirstName} chip to personalize it. Keep it short: a long text is billed as several messages.
- Select Next. Text campaigns have no From name, Reply-to or test send.
- Leave Send now selected, select Send campaign, read the count and press Send to {n}.
The report for a text campaign shows only the Delivered card, because texts carry no open or click tracking. The recipients table still lists every person, with an Error for anyone the provider rejected.
If someone removes the workspace's texting number or mailing address while a campaign is queued, every remaining recipient fails and the campaign ends as Failed.
Worked examples: after the send
Most of the risk in campaigns comes after the first send, when you want to send something again. These three examples cover the three tools — Resend…, Retry failed and Duplicate — and when each is the right one.
Example 3 — Chasing non-openers of a price-list announcement (warehouse and distribution)
A distributor emailed its new price list, attached as a File block, to all contacts tagged Retail account. A week later the open rate is 38%. The sales manager wants one reminder to everyone who has not opened it.
- Open the campaign's report from the list.
- Select Resend… in the header (or in the row menu on the list).
- Choose Non-openers only ({n} recipients). If the dialog adds a note that the campaign was sent before open tracking existed, stop: non-openers would mean everyone.
- Select Resend once. The button reads Queuing…, then Tansi opens the new campaign's report, named with (resend).
There is no schedule step and no second confirmation. If you want to change the subject for the reminder (for example Reminder: new prices from June 1), choose Pick a new list (opens a copy in the campaign wizard) instead. That opens a draft you can edit, and the audience is resolved fresh when you send.
Remember that open tracking undercounts. Some people in the non-openers group did read the first email with images blocked. Keep chasers to one.
Example 4 — Retrying after a mail outage (office and professional services)
An accounting firm sent its tax-season checklist to all contacts. The report shows Partially sent and the row menu offers Retry failed (42). The Error column shows a temporary provider problem for those 42.
- Read a few rows in the Error column first. If the error is a bad address, a retry will fail again; fix the contact records instead.
- Select Retry failed (42). The dialog Retry failed sends says it queues a new campaign and cannot be undone.
- Select Retry. You see Retry queued for 42 recipient(s) and land on the new campaign, which carries a Retry of #{id} chip linking back.
Anyone who opted out since the first send is dropped. If that leaves nobody, Tansi says so and sends nothing.
Example 5 — Re-running last year's patient recall for this year (health)
A dental clinic sends a yearly check-up recall to patients tagged Recall — spring. This year it wants the same design but the current tag membership. This example is clinical, but the same steps work for any repeat mailing — an annual equipment-inspection reminder, a renewal notice, a seasonal menu.
- Open last year's campaign and select Duplicate. A copy named (copy) opens on step 1. Duplicate is not offered on a draft; open the sent campaign.
- Check the audience. Because the copy is a new campaign, the tag is resolved again when you send, so new patients are included and people who left are not.
- On step 2, update the dates in the text. The poll, if any, starts again at zero votes.
- Test, then schedule as in Example 1.
| You want to | Use |
|---|---|
| The same message again, to exactly the people it reached | Resend… › Original recipient list |
| A reminder to people who did not open | Resend… › Non-openers only |
| Another try for addresses that failed | Retry failed (n) |
| Changed wording, a new audience, or a review before it goes | Duplicate |
Messages you may see, and what to do
Campaign screens explain most problems in a short message at the bottom of the screen or in a colored box. This table collects them, grouped by where you meet them.
In the editor
| Message | What it means | What to do |
|---|---|---|
| Campaign name is required. | You tried to reach step 3 without a name. | Type a name on step 2. Recipients never see it. |
| Subject is required for email campaigns. | No subject on an email. | Add a subject on step 2. |
| Add at least one block to the email. | The design is empty. | Add a block, or pick a starter layout. |
| Message body is required. | A text campaign, or an older plain-text email, has no body. | Write the message on step 2. |
| Give the draft a name first. | You pressed Save draft with no name. | Type a name. Autosave uses Untitled campaign, but a manual save needs one. |
| Pick at least one company, tag or person. (or the list and user versions) | A specific selection with nothing picked. | Pick something, or change the record type. |
| The CRM audience changed to specific companies, people or tags… | You picked a list, a Tansi user or a pasted address while on Leads, Contacts or Event attendees. | Nothing, if that was intended. Remove those picks to get the other record types back. |
| Click into the subject first, then pick a token… | A merge chip had nowhere to go. | Click in the subject, then the chip. Inside the email use Insert field. |
| This template's content is unreadable. | A saved template is damaged. | Pick another template, or delete this one on Campaign Templates. |
| The From name can be at most 150 characters. / Enter a valid email address. | A sender field on step 3 is too long or not an address. | Shorten or correct it. |
| The recipient count couldn't be worked out… | The count on step 3 failed. | Carry on; it is checked again when you press Send. |
| This campaign would reach nobody… | Everyone matched is opted out, bounced or has no address. | Go back to step 1 and change the audience. |
| Pick a date and time for the scheduled send. / The scheduled send time must be in the future. | Schedule fields incomplete or in the past. | Fix the date or time. |
| Too many test emails — try again in a few minutes. | More than five tests in ten minutes. | Wait, then send one more. |
| The test email could not be sent. | The mail provider refused the test. | Check the address and try again. |
| An unexpected error occurred while queuing the campaign. / …while saving the draft. | Something failed on the server. | Try again; if it repeats, report it. |
On the list and the report
| Message | What it means | What to do |
|---|---|---|
| You don't have access to do that with this campaign. | The campaign reaches records you cannot see, or you lack the permission. | Ask someone with CRM administration access. |
| This campaign changed since the list loaded… | Someone else, or the sending job, moved it on (for example a schedule fired). | Refresh the page and look again. |
| This campaign is queued — wait for the send to finish before archiving it. (on the report page; the list shows the changed since the list loaded message instead) | Archive was refused while queued or sending. | Wait for it to finish, or cancel the schedule first. |
| Only a finished campaign can be resent. | Resend on a draft, queued or sending campaign. | Wait until it finishes. |
| Everyone left to send to has since opted out — there is no one to send to. | A retry found nobody still reachable. | Nothing to do; that is the opt-outs working. |
| Campaigns couldn't be loaded. Please try again. | The list failed to load. | Refresh. If it repeats, report it. |
| Campaign not found. | The report address points at a campaign that does not exist or is in another workspace. | Go back to the list. |
| You don't have access to CRM Campaigns. | You lack CRM administration access. | Ask whoever manages permissions. |
When sending is blocked outright
Two workspace settings stop every send: a missing mailing address (email) and a missing texting number (text). Step 3 shows a red box for the first and the channel choice is grayed out for the second. Both need an administrator.
The status lifecycle
A campaign stores one of six statuses. Scheduled is not one of them — it is how the screen describes a queued campaign whose send time is still in the future. Archived is not one either; it is a separate flag that can sit alongside most statuses.
| Status | What it means | How it is labeled on screen |
|---|---|---|
| Draft | Still being built. Nothing has been sent and no recipients are fixed. | Draft |
| Queued | Handed to the sending job. The recipient list is already frozen. | Queued, or Scheduled when the send time is in the future |
| Sending | The job has claimed it and is working through the batches. | Sending |
| Completed | Finished with no failures. | Sent in the list, Completed on the report |
| PartiallyCompleted | Finished with some sent and some failed. | Partially sent / Partially completed |
| Failed | Finished with nothing sent. | Failed |
Every move a campaign can make
| From | To | What causes it |
|---|---|---|
| — | Draft | Saving a draft, by hand or by the 60-second autosave. |
| Draft | Queued | Send or Schedule from the editor. Tansi validates, freezes the audience and records the queue time plus any scheduled time. |
| — | Queued | Sending with no draft behind it, a Retry failed, or a Resend. Each of these creates a brand-new campaign that is already queued. |
| Queued | Draft | Cancel scheduled send, and only while the send time is still in the future. It deletes the recipient snapshot and resets the recipient count to zero. |
| Queued | Sending | The once-a-minute job claims it — one campaign per minute, oldest first, never an archived one, and never before its scheduled time. |
| Sending | Completed | The run finished with no failures. |
| Sending | PartiallyCompleted | The run finished with both successes and failures. |
| Sending | Failed | Nothing was sent and something failed. Also set outright when the mailing address or workspace phone number has gone missing at send time, when the opt-out lists cannot be loaded, or when the design cannot be rendered. |
| Sending | Failed or PartiallyCompleted | An unexpected error part way through. Tansi records what the mail provider had already accepted and closes the campaign off rather than leaving it stuck in Sending. |
| Completed, PartiallyCompleted or Failed | archived | Archive. A flag, not a status. |
| archived | not archived | Restore. |
| Draft | gone | Delete draft. A permanent deletion, and drafts are the only thing it can be done to. |
Individual recipients carry their own status as well: Pending, Sent, Failed or Skipped, with hard or soft bounce shown on top of Sent.
A campaign sitting at Queued for several minutes is usually waiting its turn behind other queued campaigns, because only one is claimed per minute. A campaign that went to Failed with nothing sent is almost always a missing mailing address or a missing workspace phone number — check those before anything else.
Every page in this module
Pages you use
| Address | Name | What it is for |
|---|---|---|
| /crm/campaigns | Campaigns | The campaign list, the filters and the New campaign button. |
| /crm/campaigns/{id} | Campaign report | One campaign's results: the five cards, top links, the opens chart, poll results, the recipients table, the message and the details. |
| /comms/campaigns | Mass Communication Campaigns | The other door onto the same pool of campaigns, offering subscriber lists, pasted addresses and Tansi users as audiences. |
| /comms/campaigns/{id} | Campaign report | The same report, reached from the Mass Communication side. |
| /crm/contacts/{id} | Contact detail | Carries the campaign history panel for that contact. |
| /crm/leads/{id} | Lead detail | Carries the campaign history panel for that lead. |
Pages your recipients see
These need no sign-in. The link itself is what identifies the person, so treat any of these addresses as personal to the recipient and do not share them.
| Address | Name | What it is for |
|---|---|---|
| /unsubscribe/{token} | Unsubscribe | The page the current footer links to. Offers Unsubscribe from these lists and Unsubscribe from all emails from {Workspace}, and does nothing until a button is pressed. |
| /crm/unsubscribe/{token} | Unsubscribe (older link) | The older per-person link. It acts immediately on load with no button. |
| /crm/poll/{token}/{blockId} | Poll thank-you | Confirms the answer a recipient chose, and shows the running results when Show results to voters was turned on. |
Training
Courses and certifications — taking them, and running them. Two halves in one module: what you do as a learner, and what you do as a trainer.
Before you start
Two halves, and you probably only need one
Training is the clearest-cut module in Tansi. Its two section buttons say it all:
| Section | You are… | What you do here |
|---|---|---|
| Learn | a learner | Find courses, take them, collect your certificates. |
| Deliver | a trainer or administrator | Build courses, mark work, issue certificates, and if you sell training, get paid for it. |
Most people in an organization only ever need Learn, and only three pages of it. If that is you, read sections 2 and 3 and stop there.
Webinars, meetings and the pages that manage them appear only where your workspace has them switched on. If the guide mentions a page that isn't in your menu, your organization either doesn't use it or hasn't given you access.
Every screen here is a real capture from a demo workspace.
Glossary
| Term | What it means |
|---|---|
| Course | A piece of training made of steps you work through at your own pace. |
| Webinar | Training delivered live at a set time, that you register for. |
| Enrollment | Being signed up to a course. Assigned to you, or chosen by you. The course list button is labeled SHOW ENROLMENT on screen. |
| Pass mark | The score you need to pass. Set per course — 70% and 80% are common. |
| Certificate | Proof you completed a course. Issued from a certificate template. |
| Certificate template | The design a certificate is issued from. One is the default. |
| Draft / Published / Archived | A course's status. Only published courses can be taken; archived ones are retired but kept. |
| Manual grading | Marking short-answer quiz responses a computer can't score. |
| Assignment | Work a learner submits for a person to review. |
| Resource | A document, video or other reference material in the library, alongside the courses rather than inside them. |
| Category / Tag | How resources are filed and labeled so they can be found. |
| xAPI | A standard for recording learning activity, including activity that happens outside Tansi. |
| LRS | Learning Record Store — where xAPI statements are kept. |
| License | Seats on a course bought by a company for its people. |
| Bill-Me-Later | A company asking to be invoiced rather than pay up front. |
| Public store | A shareable page listing the courses you have published publicly. |
Finding and taking training
Browse Courses
Discover training courses and webinars to advance your career. Everything available to you, in one catalog.
| Control | What it does |
|---|---|
| All / Courses / Webinars | Switch between self-paced courses and live webinars, or see both. |
| Categories | Narrow to a subject area. |
| Price | Free only, or a minimum and maximum. |
| Rating | 4+, 3+, 2+ stars, or any. |
| Duration | Under 1 hour, 1–3 hours, 3–10 hours, 10+ hours. |
| Certificate | Only training that issues a certificate. |
| Sort by | Reorder the results — newest first by default. |
| CLEAR ALL FILTERS | Start again. |
Each card shows the title, its rating, its price (or Free) and its length. The count above the results tells you how many of the total you are looking at.
My Courses
Track your assigned training courses and continue learning. Everything you are enrolled in, whether you chose it or it was assigned to you, and how far through you are. This is where you go to carry on.
My Certificates
View and download your earned training certificates. Everything you have completed. Certificates appear here on their own once you pass — you don't have to claim them.
My Certificates is also listed under Home, and the qualifications on your profile are the same record. You do not need to copy a certificate from one place to another.
Resource Library
Browse documents, videos, and more. Reference material that sits alongside the courses rather than inside them — searchable, and filtered by category and resource type.
Building and publishing courses
Course Management is where training is built: create, manage, and publish training courses for your organization.
The four counters
| Counter | What it means |
|---|---|
| All courses | Everything, whatever its state. |
| Draft | Being built. Nobody can take a draft. |
| Published | Live. These are what learners see in the catalog. |
| Archived | Retired. Kept for the record, but out of circulation. |
What each course row tells you
- Course — the title and its description. Tansi flags No description and No duration in orange, because both matter to someone deciding whether to take it.
- Status — draft, published or archived.
- Category — Class, Type and Sub-type. Not set until you set them.
- Pass mark — the score needed to pass.
- Length — how long it takes.
- Created — when it was made.
The controls along the top
| Control | What it does |
|---|---|
| CREATE COURSE | Start a new one. |
| TABLE / CARDS / KANBAN | Three ways of looking at the same list. Kanban is useful while several courses are in progress. |
| SHOW ENROLMENT | Bring enrollment numbers into the view. (Tansi spells this button ENROLMENT; it is quoted here exactly as it appears on screen.) |
| Set up your public store | Configure the shareable page listing your public courses. |
| BACKFILL CERTIFICATES | Issue certificates for completions that predate the certificate setup. |
Tansi flags them in orange for a reason. Duration and category are what the catalog filters run on — a course with neither is much harder for a learner to find, however good it is.
Archive rather than delete. An archived course keeps the completion records and the certificates that were issued from it; removing it takes that history with it.
Marking work
Tansi can mark most things itself. Two kinds of work need a person, and each gets its own page so neither hides behind the other.
| Page | What waits there | Counter |
|---|---|---|
| Grading | Short-answer quiz responses that a computer cannot score. Tansi calls it Manual Grading. | Awaiting review |
| Pending Submissions | Assignment submissions, across every course. Tansi calls it Pending Assignment Grading. | Total pending |
Both pages say All caught up! when there is nothing to do, so a glance is enough.
A short-answer question inside a quiz and a submitted assignment are different things and land on different pages. Being clear on Grading does not mean Pending Submissions is clear.
Certificates
Certificate Templates — create and manage certificate templates for your training courses. A template is the design; the certificate is what gets issued from it when someone passes.
| Column | What it tells you |
|---|---|
| Name | What the template is called. |
| Layout | Landscape or portrait. |
| Default | Whether this is the one used when a course doesn't name another. |
| Status | Active or not. Only active templates can be used. |
| Created | When it was made. |
CREATE TEMPLATE adds one. The row actions let you edit, duplicate or deactivate an existing template — duplicating is usually the quickest way to a variant.
Editing a template changes what future certificates look like. It does not reissue the ones already earned, and it should not — a certificate is a record of what was awarded at the time.
If certificates were set up after people had already completed a course, BACKFILL CERTIFICATES on Course Management issues the ones that were missed.
Selling training
Courses can be free or paid. If yours are paid, two pages cover the money.
Payment Reports
Revenue, fees, and license summary for your courses.
| Figure | What it means |
|---|---|
| My course revenue | Gross, from completed sales. |
| Platform fees | Deducted by the platform. |
| Net earnings | After fees and taxes. This is what actually reaches you. |
| Refund rate | Refunds as a share of transactions. |
Below the figures, a Transactions table (date, course, items, buyer, type, amount, tax, fee, net, status) and a License Summary showing, per company and course, the total seats bought, how many are used, how many remain and when they expire. Filter by date range and transaction type, and EXPORT the result.
Bill-Me Requests
Review and approve or reject invoice-based payment requests from companies. An employer asks to be invoiced rather than pay up front; the request lands here for approval. They are then billed at month end for every course their people took that month.
A company buys a number of seats on a course. Used and Remaining tell you how many are left, and Expires tells you when the unused ones stop being usable.
The resource library
Not everything worth sharing is a course. The Resource Library holds documents, videos and other material that sits alongside the training.
| Page | What it does |
|---|---|
| Resource Library (Learn) | The learner's view — browse and search what has been published. |
| Manage Resources (Deliver) | Add and maintain resources. ADD RESOURCE creates one. |
| Categories | The subject folders resources are filed under. |
| Tags | Labels for cutting across categories. Each has a name and a slug. |
An empty library is easy to search. A full one is not. Setting up categories and tags before you load fifty documents is much easier than retrofitting them afterwards.
xAPI and the LRS
These two exist so that learning which happens outside Tansi can still be recorded against a person. They are set up once, normally by Tansi, and then left alone.
xAPI Activity
View learning activity from xAPI-enabled course steps and external systems. Shows total statements, unique learners and unique activities, filterable by verb, course and date range. A statement is one recorded event — somebody did something.
LRS Settings
Manage API key pairs for external systems to send xAPI statements.
CREATE CREDENTIAL makes a key pair. The page shows the integration details an outside system needs — the endpoint to post to, and that it authenticates with the API key as the username and the secret as the password.
An API key and secret let an outside system write learning records into your workspace. Treat them the way you would a password: give them out only to a system that needs them, and have them replaced if they leak.
Clients do not normally touch either page — Tansi sets the integration up. If you are looking at an empty xAPI Activity report and expected data, the question is whether the external system is actually sending, not whether the report is broken.
Every page in this module
| Menu item | Section | What it's for |
|---|---|---|
| Browse Courses | Learn | The catalog of courses and webinars available to you. |
| My Courses | Learn | Training you're enrolled in, and your progress. |
| My Certificates | Learn | Certificates you've earned, to view and download. |
| Resource Library | Learn | Documents, videos and reference material. |
| Course Management | Deliver | Create, manage and publish courses. |
| Certificate Templates | Deliver | The designs certificates are issued from. |
| Grading | Deliver | Short-answer quiz responses needing manual review. |
| Pending Submissions | Deliver | Assignment submissions awaiting review. |
| xAPI Activity | Deliver | Learning activity recorded through the xAPI standard. |
| LRS Settings | Deliver | API credentials for external systems sending xAPI. |
| Payment Reports ALSO | Deliver | Revenue, fees and licenses for paid courses. |
| Bill-Me Requests | Deliver | Companies asking to be invoiced rather than pay up front. |
| Manage Resources | Deliver | Adding and maintaining library resources. |
| Categories | Deliver | Subject folders for resources. |
| Tags | Deliver | Labels for resources. |
Where a workspace has webinars switched on, this module also carries Webinars, My Webinars, Meetings and Webinar Management. They were not available on the account used for this guide, so they are named here rather than described.
Assets & Inventory
What you hold, where it sits, what is running low and what is on its way in — plus the requests that move it all around.
Before you start
What Assets & Inventory is for
This module answers four questions about the things your organization holds: what have we got, where is it, what is running out and what is on its way in. Around those sit the requests that move stock about: supply requests, purchase orders, transfers between your own sites and returns.
It is used by very different teams. A health authority tracks vaccines by lot and expiry. A construction company tracks tools, fasteners and safety gear across job sites. An events team tracks wristbands, radios and signage between a warehouse and venues. An office tracks paper, toner and laptops. The screens are the same for all of them.
Inventory and assets are not the same thing
Tansi keeps both in one module but treats them differently. Inventory is stock you use up: you count it, it runs down and you reorder it. An asset is a thing you keep and track as an individual item, such as a laptop or a defibrillator. The Item Master counts them separately, and Stock Levels gives each its own view.
How much of this applies to you
| If you… | You mainly need |
|---|---|
| Take supplies to do your job | Withdraw Supplies (your workspace may call it something else, such as Dispense) and, if you are asked, My Order Feedback. |
| Receive deliveries | Receive Deliveries or Inbound Deliveries, and Scan & Receive. |
| Ask for or order stock | The Hub and the request pages, plus Reorder Suggestions. |
| Run a stock room or warehouse | Most of the Stock and Warehouse pages, Lots and Inventory Reports. |
| Set the module up | The Admin pages: categories, locations, carriers, request settings and imports. These are set up once and then adjusted now and again. |
What decides what you see
This module is more permission-controlled than most, because it covers money, controlled goods and other people's stock. Three things decide what you see:
- Your role's permissions. Each page has its own permission, and many buttons need a higher level than the page itself. You might see the Lots board but not the Quarantine button.
- Your locations. Depending on your role, you may only see and change stock at the locations you are assigned to. Lists, counts and reports then cover only those locations, so two people can see different totals on the same page.
- Your workspace's settings. Some names change from workspace to workspace. A purchase order might be called a Purchase Request, and Withdraw Supplies might be called Dispense. This manual uses the default names.
If a page described here is not in your menu, or opens with You don't have permission to access this page., your role does not include it. Ask your administrator rather than looking for a way round it.
Dispensing is not limited to medical use. Many examples in this manual come from clinics, because vials and doses show the idea clearly, but the same tools work for any supply that is opened once and used a little at a time: a drum of cleaning concentrate, a pail of sealant on a job site, a case of event wristbands or a box of fasteners.
Glossary
Stock control has its own language, and Tansi uses it consistently. Read this once and the rest of the module reads easily.
Items and catalog
| Term | What it means |
|---|---|
| Item | A product or asset in your catalog. Items live in the Item Master. |
| SKU | Your own code for an item, such as a part number. |
| UoM | Unit of measure: Each, Box, Vial, Meter — the unit an item is counted in. |
| Asset | An item tracked one by one and kept, rather than used up. |
| Category and child category | The tree items are filed under. A category can carry its own extra fields, called category fields. |
| Custom dropdown | A named list of values, such as a list of brands, that a category field can offer. It is a list, not a field. |
| Generic item (parent) | An item that stands for several specific products, its child items. When you pick a generic item by hand, Tansi may ask Which product? |
| Critical, Controlled, Hazardous, High risk | Flags on an item that show as small labels. Controlled items take extra approval; critical items must never run out. |
| Credit return | The supplier takes the item back for credit, so you send it back instead of throwing it away. |
| GTIN, GS1 barcode | The global product number in a barcode. A GS1 barcode can also carry the lot number, expiry date and serial number, which Tansi reads when you scan. |
| Go-UPC | An outside product database Tansi can look a barcode up in, to fill in a new item. |
Locations
| Term | What it means |
|---|---|
| Location | A place in your hierarchy: a region, site, warehouse, room, shelf or bin. Each one answers to the location above it, its parent. |
| Location type | The kind of place, such as Warehouse or Clinic. Used for labels and colors. |
| Storage spot (storage-enabled location) | A location where stock can actually sit: a shelf, fridge, bin or cabinet. Grouping levels such as a region are not storage spots. |
| Storage area | A free-text name for a spot inside a location (for example Cabinet 2), used on older stock and in some dialogs. |
| Tier | A distribution level you can give a location: Tier 1 (for example a provincial depot), Tier 2 (a regional depot), Tier 3 (a community site). |
| Ship-to location | A location a supplier can deliver to. It is offered in a purchase order's Ship To picker. |
| Receives in Tansi | A location whose people receive deliveries in Tansi, so stock is sent to it as a transfer. |
| Partner site | A location you can send to or request from but whose stock you cannot see. |
| Assigned people | People who work at or belong to a location. Depending on their role, this decides which locations' stock they can see and change. |
Stock levels and ordering
| Term | What it means |
|---|---|
| On hand | Everything physically there. |
| Reserved | On hand, but already promised to a request or held. |
| Available | On hand minus reserved: what you can actually use. |
| Min, Reorder, Max | Stock levels for an item. Below min is urgent; at or below the reorder level the item is Low and should be reordered; max is the level to top up to. |
| Level override | Min, reorder and max set for one location only, instead of the item's default. |
| Order multiple | Order quantities round up to this number, for example cases of 12. |
| Lead days, Safety days | How long a delivery takes, and how many extra days of stock to keep. |
| Ordering schedule | How often a facility is due to order, for example every second Monday. A blackout date is a day it does not order. |
| Request | The paperwork that moves stock: a Supply Request, Purchase Order, Stock Transfer or Return. |
| Request template | A saved list of items to start a request from. |
| Not allowed item | An item a location may not order. Blocks set on a parent apply to every location under it. |
| External PO | Your finance system's purchase order number. Your workspace names it. |
| Exceptional receipt | A delivery received without a Tansi purchase order or transfer behind it. |
| Delivery withdrawal | Stock shipped to a department or place with nobody on Tansi to receive it. |
| Return on hold | Stock a station sent back, held until someone restocks, disposes of or returns it. |
| Days of cover | How long stock lasts at its average daily use. |
| Snapshot | A saved copy of the reorder list at a moment in time. |
| Funding source | Where the money came from, tagged onto lots and order lines for reporting. |
| Carrier | A shipping company, such as a courier or freight line. |
| Order feedback survey | A form sent to sites asking what they need, before a buyer places orders. |
Lots and expiry
| Term | What it means |
|---|---|
| Lot | A batch of an item made or received together, with its own lot number and usually an expiry date. Expiry, quarantine and recalls attach to the lot. |
| Lot-tracked item | An item that requires a lot number or an expiry date when it is received. |
| (Unspecified) lot | Stock of an item that came in without a lot number. You can give it real lots later with Assign lots to untracked stock. |
| Active | A normal lot that can be used and sent. |
| Quarantined | A lot on hold while something is checked. It is still on hand, but must not be shipped or used. |
| Suspended | A lot temporarily taken out of use. |
| Recalled | A lot under a recall notice from the maker or supplier. |
| Flagged | On the Lots board: recalled, quarantined or expired lots. |
| Expiry window | How far ahead counts as expiring soon. You can set it in days, weeks, months or years. |
| FEFO | First Expired, First Out: Tansi suggests the lot that expires first, so older stock is not left to go out of date. |
Day-to-day stock work
| Term | What it means |
|---|---|
| Withdrawal | Recording supplies issued to a person, there and then. |
| Dispense | Open one unit of a multi-use item and give doses or uses from it over time. Also the name many workspaces give the Withdraw Supplies page. Not limited to medical use. |
| Contains multiple units | The item switch that counts stock in the doses or units inside each container (container mode). |
| Container | One vial, box or package of a multi-dose item, tracked individually, optionally with its own barcode. |
| Uses mode | A multi-use item counted in whole units on the shelf; doses are tracked only on an opened unit. |
| Dose | One use from a multi-dose unit: one injection, one scoop of cleaner, one can from a case. |
| In-use window | How long a unit can be used once opened: the item's Expires after opening (hours). |
| Clock | The countdown on an open unit, to the end of its in-use window or its lot expiry, whichever comes first. |
| Adjustment | A correction that says the recorded quantity was wrong. |
| Waste | Stock that existed and was lost, with a reason. |
| Stock ledger | The complete history of every movement in and out (Transaction History). |
| Shared account | A station login used by several people; withdrawals and waste then ask for the person's name. |
How the module is laid out
Assets & Inventory is a large module, so its menu is split into section buttons, as described in Module 02. Pick Assets & Inventory in the module switcher. Four pages sit at the top and are always shown, because they are what people do most. Below them are five section buttons: Stock, Warehouse, Surveys, Reports and Admin. Picking a button shows that section's pages.
| Section | Pages | Who uses it |
|---|---|---|
| (always shown) | Hub, Withdraw Supplies, Move Stock, Receive Deliveries | Everyone, depending on their permissions. |
| Stock | Item Master, Stock Levels, Lots, Reserved Stock, Returns on hold, Stock Review, Critical Items, Waste Management, Reorder Suggestions, Order Schedule, Inventory Count | Whoever manages what you hold. |
| Warehouse | Scan & Receive, Inbound Deliveries, Withdraw for Delivery, Transaction History | Whoever handles stock physically. |
| Surveys | Manage Feedback, My Order Feedback, Snapshot History | Buyers who ask sites what they need, and the sites that answer. |
| Reports | Inventory Reports, Operations Reports, Audit Log | Supervisors and anyone who has to account for stock. |
| Admin | Categories, Suppliers, Contracts, Carriers, Custom Dropdowns, Workspace Lists, Location Management, Request Settings, Request Permissions, Access Center, Data Import, Funding Sources | Administrators. Set up once, then adjusted. |
Pages that appear in more than one place
- My Order Feedback is also under Home › My Work, so people who only answer surveys never need to open this module.
- Most Admin pages, plus Snapshot History, are repeated in the Admin module under its Inventory button. They are the same pages.
- The Maintenance module has an Inventory link under Reports that opens Stock Levels for maintenance stock.
- Receive Deliveries and Inbound Deliveries open the same page. Receive Deliveries is the entry for sites that only receive transfers; warehouse staff who receive purchases use Inbound Deliveries.
Names your workspace may change
Administrators can rename some pages and request types in Request Settings. Withdraw Supplies is often renamed Dispense, and the purchase order may be called something like Purchase Request. Buttons follow the new name: Receive without a Purchase Order becomes Receive without a Purchase Request. This manual uses the default names.
If you are not sure where something lives, open the Hub. It groups the module's everyday work into labeled blocks and shows only the tiles your permissions allow.
Dispensing is not limited to medical use. Many examples in this manual come from clinics, because vials and doses show the idea clearly, but the same tools work for any supply that is opened once and used a little at a time: a drum of cleaning concentrate, a pail of sealant on a job site, a case of event wristbands or a box of fasteners.
Menu entries and pages are permissioned separately. Carriers is shown in the menu to people with the suppliers permission, but the page itself checks the stock-tracking permission. If someone sees the menu entry but is refused, or can open the page but has no menu entry, check both permissions for their role.
Requests at a glance
A request is the paperwork that moves stock. Somebody asks for something, somebody approves it, and the warehouse or a supplier makes it happen. Tansi keeps every kind of request in one place, with the same stages, the same page layout and the same list, so once you can read one you can read them all.
The four kinds
| Kind (default name) | Number starts | What it does |
|---|---|---|
| Supply Request | SR- | Someone asks for stock to be sent to a location. It is a statement of need: we need this here. How it is filled is decided after approval. |
| Purchase Order | PO- | Buying from a supplier. Stock comes in from outside. |
| Stock Transfer | TR- | Moving stock between two of your own sites. Nothing is bought; it changes place. |
| Return | RTN- | Items going back to a supplier against the purchase order they arrived on. Stock going back to your own warehouse is also called a return, but it is a transfer underneath and gets a TR- number. |
After the prefix comes the year and a sequence, so SR-2026-0001 is the first supply request of 2026. Reports, pick lists and the scanner all use this number.
An administrator can rename the request types in Request Settings. A workspace might call purchase orders Purchase Requests or supply requests Order Requests. Every page, button and message follows the new names, so New Purchase Order may read New Purchase Request on your screen. This manual uses the default names.
The pages
| Page | What it is for |
|---|---|
| Hub | The front door: counters, shortcuts to every request page, and your work queues. |
| New request | Search for what you need and Tansi suggests the right kind of request. |
| Request editor | Where a draft is written: where it is going, what is on it, and why. |
| Request page | One request, start to finish: its stage, its lines, who approved it, and the buttons for whatever happens next. |
| Lists | My requests, all requests, and one list per kind. |
| Approval Inbox | Everything waiting for your decision. |
| Templates | Orders you place again and again, saved once. |
| Bulk import | Build a supply request from a spreadsheet. |
How much of this applies to you
- You ask for stock (a nurse, a site foreman, an office manager): the hub, New request, the editor and your own list. Most of the time you raise supply requests.
- You approve: the Approval Inbox and the approval panel on each request.
- You fill requests (storeroom, warehouse, purchasing): the supply, purchase and transfer panels, shipments, receiving and, for purchasing, invoices.
- You set things up: templates here, and Request Settings in the admin area.
Requests are permission-heavy. Which kinds you may raise is set in Request Permissions; viewing, approving, filling each kind, receiving, managing templates and seeing costs are separate rights. Tansi hides any card or button you would only be refused on. If a colleague sees something you do not, ask an administrator.
The Requests hub
Open Assets & Inventory › Hub. The page title is your workspace's word for requests, with the line Stock Transfers, Purchase Orders, and Supply Requests in one place.
The header
| Control | What it does |
|---|---|
| Scan icon | Scan barcode / QR. Opens the device camera, where your organization has camera scanning turned on. A handheld scanner works on this page without pressing anything. |
| Import CSV | Opens Bulk import, to build a supply request from a spreadsheet. |
| New Request | Opens the New request page. |
Scanning on the hub first looks for a request with that number or barcode and opens it. If nothing matches, Tansi says No request matched “…”. Starting a new request. and opens New request with the code, treating it as an item barcode.
The four counters
| Counter | Counts | Opens |
|---|---|---|
| Drafts | Requests started and not sent | My requests |
| Pending Approval | Requests waiting on an approver | Approval Inbox |
| Active | Approved requests being worked | All requests |
| Completed (30d) | Requests finished in the last 30 days | All requests |
All four count every request in the workspace, not only yours. Drafts opens your own list, so the number on the tile can be larger than what you find there.
The four groups of cards
Cards are grouped by what you are trying to do. Each group shows how many of its cards you can see; a group with none is hidden.
| Group | Card | Shown when you can… |
|---|---|---|
| Start & track | My Requests | view requests |
| Approvals (with a count badge) | approve requests | |
| All Requests | view every request in the register | |
| Request types | Supply Requests (listed first) | view requests |
| Stock Transfers | raise transfers, fill transfers, or view all requests | |
| Purchase Orders | fill purchase orders | |
| Returns | raise returns, fill transfers, or view all requests | |
| Warehouse operations | Warehouse Queue | fill transfers |
| Inbound Deliveries | receive purchases | |
| Exceptional receipts | receive purchases | |
| Returns on hold (with a count badge) | receive transfers and either fill transfers or have returns waiting at your places | |
| Withdraw Supplies (your workspace may rename it, for example to Dispense) | withdraw stock | |
| Withdraw for Delivery | withdraw for delivery | |
| Move Stock | move stock inside a location | |
| Receive Deliveries | receive transfers but not purchases | |
| Manage | Templates | manage request templates |
| Settings | manage workflows (opens Requests Admin) |
The Withdraw Supplies card carries a medical-kit icon, and many workspaces rename it Dispense. Examples about it often come from clinics, but the page works for any stock that people take for their own use or hand out: hard hats and gloves on a building site, toner and paper in an office, radios and lanyards at an event, or parts at a warehouse counter.
The panels at the bottom
| Panel | What it lists |
|---|---|
| Supply Requests to fill | Only for people who fill supply requests. Approved supply requests nobody has sourced yet, with Not started or Partly filled, the location, how many lines wait and who asked. A request leaves once every line is covered by a transfer or purchase order. Empty: Nothing waiting. |
| My recent requests | Your last five, newest change first, with stage and need-by date. Completed and canceled ones have a Duplicate icon. |
| My shipments | Transfers shipped to or from your locations: Incoming and Outgoing tabs, in transit first, then the last two weeks of receipts. It opens on Outgoing if nothing is incoming. |
| Awaiting my approval | The top five in your inbox, each with a Review button. Empty: All caught up. |
A supply request on a route with no approval step goes straight to the people who fill it. It is not in anyone's Approvals and not yet in the Warehouse Queue, because no transfer exists. Supply Requests to fill is where it shows up.
How a request moves
Every request, whatever its kind, moves through the same five stages. The bar across the request page shows where it is, in words as well as dots: Stage — step 3 of 5, approved.
| Stage | What it means | What moves it on |
|---|---|---|
| Draft | Being written. Only drafts can be edited. | The requester submits it. |
| Pending | Submitted and waiting on an approver. The list and chips say Pending approval. | The approval route finishes. A route with no approval step skips straight on. |
| Approved | Agreed, but nothing has physically moved yet. | Work starts: stock is allocated, picked or shipped, or the order goes to the supplier. |
| Active | In progress: being picked, shipped, ordered or delivered. | Everything is received or closed. |
| Completed | Finished. | — |
Two endings sit outside the bar. A Rejected request shows a red block and a Cancelled request a gray block in place of the five dots.
Fulfillment is a separate thing
Beside the stage you often see a Fulfillment value, such as Routed or Shipped. Stage is how far through the paperwork the request is; fulfillment is what is happening to the goods. A request can be Active with fulfillment Shipped: approved, on its way, not yet received.
Going backward
- Recall: while a request is pending and nobody has decided yet, the person who raised it can pull it back to Draft, fix it and submit again.
- Return for clarification: an approver can send a pending request back to Draft with a note saying what to change. The approval in progress is canceled and starts again on the next submit.
- Once anyone has approved or rejected, the requester can no longer recall it.
The Progress panel
On the right of every request page, Progress names the route (Route: …), shows when approval started and finished, and lists each step: Step 2 — Manager (Any), with In progress, Coming up, Done or Overridden. Under an approval step you see who approved or rejected, when, with any notes. A decision made by a stand-in reads as delegate of ….
After the approval steps, Tansi adds the milestones that follow, so one panel tells the whole story:
| Request | Milestones after approval |
|---|---|
| Supply request | Sourced (filled with a transfer or a purchase order), Shipped or Ordered, Complete |
| Transfer | Picked, Shipped (or Shipped back on a return), Received at …, Complete |
| Purchase order | Ordered, Received, Invoice verified, Complete |
Each milestone links to the requests that did the work, for example the transfer that filled a supply request.
Who sees which approvers
Administrators, workflow managers, the current approver and anyone already on the route see every person on every step. Everyone else sees only the people who have decided, plus a line such as Waiting for any one of 4 approvers. or Waiting for 1 more approval from 3 approvers. When a step is settled, anyone who did not need to act shows Not needed. On a step marked (Any), one approval is enough.
If a request seems stuck, Progress tells you whether it is waiting for an approver, for a form, for the warehouse to pick, or for receiving, and names the people involved.
Choosing the right request type
The question is always the same: where is the stock now, and where does it need to be?
| Situation | Raise | Why |
|---|---|---|
| Your site needs stock and you do not know or care where it comes from | Supply Request | You state the need. The storeroom decides after approval whether to send it from stock, move it from another site or buy it. |
| You know another of your sites has it and it should move | Stock Transfer | Nothing is bought. Stock leaves one site and arrives at the other. |
| Nobody has it, or it is bought direct | Purchase Order | Stock comes in from a supplier. |
| Stock at your location is expired, damaged, recalled or extra and should go back to the warehouse that supplies you | Return › Back to the warehouse | A return transfer: no purchase order needed. You pick from what your location holds. |
| A supplier delivered something that must go back to them | Return › Back to a supplier | It names the purchase order the items arrived on, usually with the supplier's return authorization (RMA) number. |
| You want to move stock between shelves, a cart or a fridge in one building | No request | Use Move Stock. It is immediate and needs no approval. |
Examples
- Construction: the north site office runs out of safety harnesses. The foreman raises a supply request for the site. The yard has twenty, so the storeroom fills it with a transfer.
- Office: head office wants toner for a branch. The branch's admin raises a supply request; nobody holds that toner, so the storeroom raises a purchase order from it.
- Events: after a festival, forty radios go back from the venue store to the main warehouse. That is a return to the warehouse.
- Warehouse: a pallet of the wrong fittings arrived on PO-2026-0112. Purchasing raises a return to the supplier against that order with the RMA number.
- Clinic: a station is low on gauze while the depot holds plenty. The station raises a supply request; the depot fills it with a transfer.
This example comes from a clinic, but requests work the same way for any kind of stock: building materials, office supplies, event equipment or warehouse parts.
Why supply requests are the usual starting point
A supply request asks for what is needed without making the requester choose a source they cannot see. Tansi does not stock-check a supply request at submit for sourcing, and does not ask the requester to pick between stock and buying. Whoever fills supply requests makes that call after approval, and the transfers and purchase orders they raise are linked back to it.
If none of an item is available anywhere you can draw from, Tansi will not submit the supply request as it is. It offers to turn it into a transfer or purchase request instead, if you are allowed to raise those. If you are not, your draft is saved and the message tells you to ask your warehouse or manager to source it.
Starting a request
Press New Request on the hub (or New … on any list). The page opens with Start by searching for what you need. We'll suggest the best path.
Search for the item
Type in Search item. It matches name, SKU or barcode and shows up to 20 active catalog items, each with its risk chips. You can also scan. A GS1 label is matched on its product code; the lot and expiry on it do not matter here.
Once you pick an item, Tansi shows Options for … and offers only the kinds of request you are allowed to raise:
| Tile | Shown when | Button |
|---|---|---|
| Request from local stock | The item's default location has stock available. It shows the quantity and the location. | Request locally (a supply request for that location) |
| Transfer from … | One tile per other location holding the item, most first. If you may not see that location's numbers it says In stock instead of a count. | Start transfer (from that location) |
| Order from vendor | The item has suppliers on file. The preferred one is highlighted with a Preferred star; the rest are sorted by lead time. Prices show only if you may see costs. | Start Purchase Order (with that supplier) |
The tile you press opens the editor with the item already on the first line and the header filled in: the location, the source, or the supplier with its price. On a purchase order with a supplier lead time on file, the expected delivery date is set to today plus that lead time.
A restricted item shows a banner before you go further. If nothing applies you see No stock or preferred vendor is configured for this item yet. Use the escape hatches below to create a request directly.
When the item is not in the catalog
If you typed something that matched nothing, or scanned a code no item carries (No catalog item matches barcode …), the Item not in catalog tile offers New Item Request. It opens a new supply request; see Adding items for how unlisted items work.
I already know what I need
| Button | What it does |
|---|---|
| Purchase Order, Stock Transfer, Supply Request, Return | Opens a blank editor of that kind. Each shows only if your role may raise it. |
| Start from existing | Pick a completed request (filter by Type, search by number or notes). Tansi copies it into a new draft: Created SR-… from SR-…. |
| Start from template | Pick a template; For location narrows to that location's templates and marks its Default. A new draft is created from it. |
| Bulk import (CSV) | Opens Bulk import. |
If your role may raise nothing, the page says Your role is not set up to raise any kind of request yet. Ask an administrator to grant one under Request Permissions.
New return: which kind?
Return asks Where is the stock going? only if you may raise both kinds and there is an order you could name:
- Back to the warehouse — No Purchase Order needed. Expired, damaged, recalled or extra stock at your location goes back to the warehouse that supplies it.
- Back to a supplier — Needs the original Purchase Order. Items go back against the order they arrived on, usually with an RMA number.
Everyone else goes straight to the one they can raise.
Writing a supply request or transfer
The editor has two cards across the top. On the left is the card for this kind of request (where the stock goes, or who supplies it). On the right is Request details, shared by every kind. Below them is the Items table.
Supply details
Where the supplies are going.
| Field | What to know |
|---|---|
| Requested for location (required) | The site the supplies are for. Only physical sites are listed, not shelves or bins: which shelf the stock lands on is decided when it is put away. On a new request, if you are assigned to exactly one site, Tansi fills it in for you. |
| Requested on behalf of (optional) | Who the supplies are for. Pick someone assigned to that location, or type any name (a visiting worker, a relief nurse) and press Use “name”. You stay recorded as the requester. It is disabled until a location is chosen. |
| Delivery address | Where the delivery goes, if different. |
| Request template | Appears only if the location has templates linked to it. See below. |
If you are signed in with a shared site account, the field becomes Requested on behalf of and is required. Submitting without it shows You're signed in with a shared account: fill in “Requested on behalf of” with who the supplies are for.
Location templates
When the location has request templates, choose one in Request template and press Load template items. Items already on the order keep their quantities, missing ones are added, and items not allowed at that location are skipped with a message. A new, empty request picks the location's default template for you. Changing the location clears the template choice.
Some locations only accept template items. There the picker reads Request template (required here), the item search stays closed until you pick one, only that template's items can be ordered, and the unlisted-item option is turned off. Submit is blocked with Pick a request template for this location first.
Transfer details
| Field | What to know |
|---|---|
| From location (required) | Where the stock leaves from. If you started from an item, Tansi picks the site holding the most of it. |
| To location (required) | Where it arrives. On a new transfer, if you are assigned to exactly one site, it is filled in. |
If both are the same, Tansi warns that a transfer moves stock between sites and that moving inside one location needs no request.
If another transfer on the same route has not shipped yet, a box lists it. A draft can take your items: Add my items to TR-… moves your lines across, cancels this draft and opens that one (Lines moved to TR-…; TR-… cancelled.). One already in approval says already in approval — ship together and the carrier details are copied across.
Return to the warehouse
A return to the warehouse looks like a transfer with different words: Return details — Where the stock is now, and the warehouse it goes back to. No order is needed.
- Returning from: a place whose stock you can see. The items you can add are the ones this location holds.
- Send it back to: the warehouse or warehouses that supply that place, nearest first. If no supplier is set up, every location is listed and Tansi says an administrator can set it in the Access Center's sharing rules.
- Each line needs a Reason, and quantities cannot exceed what the location holds.
- A chip at the top reads Return to warehouse.
Request details
Priority, timing, and context for the approver.
| Field | What to know |
|---|---|
| Priority | Low, Normal, High or Urgent. It follows the highest line priority on its own (Auto from lines). Raise it and it stays where you put it; Overridden — clear puts it back on automatic. |
| Need by | The date you need it. |
| Project | Filled from the location's default project if empty. A project you chose is never replaced. |
| Notes for the approver (supply) | Up to 250 characters: Why these supplies are needed, and anything the approver or the storeroom should know before sending them. It shows on the request as Reason given. |
| Notes (other kinds) | Up to 4000 characters. |
If you set the request below its most urgent line, Tansi asks You're setting the request priority to Normal, but line “…” is Urgent. and wants a written reason. The reason is kept in the notes, and the header shows (overridden).
Writing a purchase order or supplier return
Purchase details
| Field | What to know |
|---|---|
| Supplier (required) | Search suppliers. Once chosen, the contact name and email show underneath. |
| Don't know the supplier? Search by item | Opens Find a supplier by item. Search by item name or SKU; each result shows its default supplier (Default supplier or Only supplier on file) or why it cannot be ordered. Use this supplier sets the supplier and adds that item to the order. |
| Supplier location | Which branch of the supplier: ordering, invoice, contact and integration defaults. Disabled until a supplier with branches is chosen. |
| Contract (your workspace may rename it) | Pick a contract, type a number not yet listed (it is added when the order is saved), or tick N/A — this order is not under a contract. Choosing a supplier fills in its default contract if you have not answered. Warnings appear for a contract that has ended, not started, is inactive or belongs to another supplier. |
| Expected delivery date | When you expect it. |
| Ship to (receiving location) | Where it is delivered. Printed in the Ship To block of the purchase order PDF and the supplier email. Places that are not delivery points say so. |
| Ship-to address | The delivery address. |
The supplier list narrows to suppliers who carry every item already on the order (Limited to the 2 suppliers of the items on this order.). If no single supplier carries them all, every supplier is shown with a warning.
Pick an item first on an order with no supplier and Tansi sets the item's default supplier for you (Supplier set to … The order is now limited to items they carry.). Change the supplier later and any item the new one does not carry must go: Tansi lists them and asks Remove 2 item(s) or Keep the previous supplier.
If no supplier is chosen yet, the Items card says You can build the order now. Select a vendor above before submitting so vendor pricing and product codes can be applied. If your workspace routes large orders differently, a line under the items says, for example, Orders of $10,000.00 or more go to “DOFA” for approval. This order is $12,400.00.
Return to a supplier
Return details — Which Purchase Order the stock arrived on, where it is being returned from, and where it goes.
| Field | What to know |
|---|---|
| Original Purchase Order (required) | Search by order number or item. Each result shows the supplier, its external PO number, its stage and the items on it. |
| Returning from (required) | The location holding the stock being sent back. |
| Send it back to | The vendor (named from the order) or One of our locations (quarantine / warehouse). |
| Vendor returns address | The supplier branch whose returns address the carton ships to. |
| Return authorization (RMA) number | Up to 100 characters. Most suppliers refuse a delivery without one — it can be added any time before shipping. |
| Destination location | When it goes to one of your locations instead. |
You can only add items that order delivered, up to the quantity actually received (or ordered, on older orders with no receiving record). Type more and Tansi caps it: Capped at 6 — the original Purchase Order only delivered 6 of this item. Switching to another order removes items it did not deliver, after asking. Each line needs a Reason: Expired, Recalled, Broken / damaged, Quarantined, End of season, Cold chain break / exposure or Other.
The Items table
The Items table appears with the first line. Its columns change with the kind of request.
| Column | On | What it holds |
|---|---|---|
| Item / description | All | The item picker, its SKU and handling chips. A description box appears only for an unlisted item or a changed description. |
| Item location | All but supply | Transfer: the first storage spot at the source holding the item, with +2 for more; click it for the location map. Purchase: the item's default location. |
| Qty | All | Whole numbers. A short hint under it when something applies (below). |
| On hand | All | Available stock at the place that matters: the source (transfer, including every shelf and bin inside it), the requested-for location (supply) or the receiving location (purchase). If you may not see that place's numbers you see In stock or None. |
| Unit | All | Unit of measure, editable. |
| Priority | All | Per line. A red mark shows when a line is more urgent than the request. |
| Unit price, Vendor code | Purchase | Filled from the supplier's catalog when known. |
| Lot | Transfer, return, supply | See below. |
| Reason | Returns | Required: why it is going back. |
| From area, To area | Transfers, when used | Shelf or bin inside the From and To locations. |
| Notes | All | Up to 2000 characters per line. |
| Bin icon | All | Removes the line at once, with no confirmation. |
Quantity hints and automatic changes
- Over max 40 — this order takes the location above its maximum stock level.
- Below min 10 — the location is under its minimum.
- Min. order 12 — the supplier's minimum order. A smaller quantity is raised: Raised to 12 — this item has a minimum order quantity of 12.
- Multiples of 6 — a pack size. Quantities round up: Rounded up to 18 — this item orders in multiples of 6.
On a purchase order, a warning icon beside the quantity opens a box showing on hand, the maximum, what you are ordering and the total after delivery, with line totals at each quantity. Choose Change to 25 to land exactly on the maximum, or Order 40 anyway. Ordering anyway is allowed, but you will be asked for a reason when you submit.
Lots
Lot-tracked items get a Lot choice. On a transfer it starts on Auto lot (Earliest expiry is sent first); pick a specific lot to send that one. On a supply request the choice appears only when there is more than one lot; leave it on Any lot and the warehouse picks the earliest expiry. A lot expiring soon shows Expires 2026-12-01. If a pinned lot runs out you see Requested lot no longer has stock.
Lines that need attention
Some lines cannot be submitted as they are. Tansi highlights each with Needs attention: and a bar above the table counts them, with Show them first, Back to list order and Next item. Pressing Submit with such lines moves them to the top: 2 items need attention before you can submit. They're at the top of the list.
| Message | What to do |
|---|---|
| Choose which product is being ordered. / …sent. | The line is a generic item (for example Gloves, nitrile). Click Generic item — choose the product and pick the actual product. The chip then reads Fulfil with …. |
| Not allowed at … Remove it, or record an override. | The destination does not allow this item. Remove it, or, if you have override rights, click the chip and give a reason. |
| For … only, so it can't be ordered for … | The item is meant for a different kind of location. Remove it or pick the item this location orders. |
| Lot … expired on … | Choose another lot, or leave it on Auto. |
| Choose why it is going back. | Pick a return reason. |
Overriding a not-allowed item needs at least 20 characters of reason and the tick I understand this override is logged and requires approval. The line shows Override recorded, a red banner on the request lists every override with who made it and when, approvers see it, and the route may add a dedicated approval step. Only people with approval-bypass rights can override; everyone else must remove the line.
Adding items
Below the table sits the add-items box. Until the header says where the stock is going, it is locked with a reason, such as Choose the requested-for location above to start adding items. or Choose the From and To locations above to start adding items., and a line about which items you will be able to add:
| Request | Which items you can add |
|---|---|
| Supply | You can request anything in the supply catalogue, including items that location doesn't stock. Its on-hand shows beside each line. |
| Transfer | The list of items comes from what the From location holds. |
| Return to the warehouse | Stock the location holds, up to what is on hand. Each item needs a reason. |
| Supplier return | Only items that purchase order delivered. |
Ways to add
| Control | What it does |
|---|---|
| Add an item by name or SKU | Type and pick. The item goes straight on the request. If it is already there, Tansi points you to it: … is already on line 3. Change its quantity there. |
| Scanner | A barcode scanner works anywhere on this page. GS1 labels also fill in the lot and expiry. A GS1 scan pins that lot if it is in stock (Lot … pinned). |
| Camera icon | Scan with the device camera, where your organization has it turned on. |
| Browse catalogue / Browse stock | A large picker grouped by category. See below. |
| Add a blank line | An empty line at the end; the cursor moves into its item picker. |
| Scan a batch | Paste a list of barcodes, or scan many in a row, then add them all at once. |
| Item not in the catalogue | Describe something that is not in the catalog. |
If a search finds nothing, Tansi says No catalogue item matches “…”. Press Enter to look it up as a barcode. and offers Add “…” as an unlisted item.
Browsing
The browse window has Search item, SKU, category or lot, Selected only and, when there is a location, In stock here only. On a purchase order an Inventory list filter offers All active inventory, Medications, Medical supplies and Expiring soon; the supplier's items come first. Each row shows available stock with chips for reserved, quarantined, expiring within 30 days, expired and recalled or suspended stock, plus Already added. Type quantities and press Apply catalogue selections: existing lines are updated, not duplicated. On a transfer you cannot exceed what the source holds (Exceeds source availability).
These two filters sort items by their category name, not by anything medical about them. Medications keeps items whose category name contains medication, pharmacy, pharmaceutical or drug. Medical supplies is everything else. In a workspace that buys lumber, stationery or event gear, Medical supplies therefore shows every item, and Medications shows nothing. The browse window itself works the same for any kind of stock.
Setting an item that is already on the request to 0 and applying removes its line. Items not allowed at the destination are hidden from the window, with a count of how many.
Scanning a batch
Paste barcodes takes one per line (Import); Live scan listens to a USB or Bluetooth scanner. Each code shows its item or Not found, with lot and expiry for GS1 labels, and an editable quantity. Add 12 item(s) to lines adds the ones found.
Items that are not in the catalog
Item not in the catalogue asks What do you need? (brand, size, model), Quantity, Unit and optional Notes. The line is flagged Not in catalogue. Nothing can be sourced, picked or received for it until someone links it to a catalog item: you can do that yourself on the draft by picking an item on the line, or the approver or warehouse does it later with Link item.
Unlisted items are not allowed on returns or at template-only locations.
Restricted and controlled items
When a restricted item is on the request, an amber box headed Approval required for restricted item lists it with its reason and the approval route: for example controlled-substance approval by …. On transfers and returns, items with handling or risk warnings ask you to acknowledge them, and the acknowledgement is logged.
When Tansi cannot find named approvers for a restricted item, the box shows a built-in route name, Regional Nurse Manager approval group, which may not exist in your workspace. Check the actual route in Progress after you submit.
Purchase order totals
A purchase order shows a totals panel under its lines. The left side is for amounts the supplier bills that are not a line; the right side adds everything up.
Line prices come first. When the order has a supplier, each line's Unit price and Vendor code are filled in from that supplier's price for the item where one is on file, otherwise from the item's catalog price. You can type over them; the line total updates as you go.
Extra costs
Amounts the vendor bills that are not a line — shipping, eco or recycling fees, handling. Press Add extra cost and fill in:
| Column | What to enter |
|---|---|
| Type | Shipping / freight, Handling, Eco / environmental fee, Recycling fee, Duty / brokerage, Discount or Other. |
| Description (optional) | Up to 200 characters, for example Courier, 2 boxes. |
| Amount | In dollars. Enter a discount as a negative amount. |
| Taxes | Tick if taxable, then pick which taxes apply; otherwise Not taxable. |
The summary
| Row | What it shows |
|---|---|
| Subtotal | The lines, with the line count. |
| Extra costs | The total of the costs on the left. |
| Taxes | One row per tax code: rate and what it applies to. You can type a different amount to match the supplier's paperwork; an undo icon puts back the calculated amount. none configured on these items when no tax applies. |
| Adjustment | Add adjustment adds a rounding or invoice-difference line, of any sign, never taxed. |
| Order total | Everything together. |
Approval routes can depend on the order's value, and the order total is what the supplier email and PDF show. A one-cent difference from the quote is what Add adjustment is for.
Extra costs typed here are the ones on the order. Fees that only appear on the delivery paperwork are recorded when the order is received, and both show in the totals on the request page afterward, with any price differences between order and receipt.
People without the right to see costs do not see supplier prices on the New request page, or prices, line totals and estimated totals on the request page and in the approval panel.
Saving and submitting
The buttons at the bottom
| Button | What it does |
|---|---|
| Cancel | Leaves the editor without saving (back to the request, or to the list for a new one). |
| Save draft | Saves and stays on the editor: Saved SR-2026-0042. A new request gets its number and its own address, so a refresh keeps it. Empty lines you never filled in are dropped. |
| Submit for approval / Submit | Saves, runs the checks below and sends it. The words tell you in advance: Submit for approval when the route this request would take has an approval step, plain Submit when it goes straight through. |
If your workspace has auto-save switched on, a draft saves itself every so often once it has a line or a note, with a small SR-… saved indicator. A request you open and walk away from without typing anything is not saved.
With auto-save on, a draft may already exist by the time you press Cancel. Find it in My requests and cancel it there if you do not want it.
What Tansi checks, in order
- Lines needing attention are moved to the top and the submit stops until they are fixed.
- Requested on behalf of is required on a shared station account.
- Item warnings on transfers and returns: acknowledge restricted or high-risk items.
- Your workspace's reminder, if one is set for this kind of request: Before you submit with Submit or Go back and review.
- Contract (purchase orders, if your workspace asks): No Contract yet. Pick one, mark it N/A, or (unless required) Submit without one. When required: Your organization requires a contract or N/A before a purchase order is submitted.
- Tansi saves the draft, then checks stock, the ordering schedule, maximum stock levels and, on supply requests, unusual quantities.
The questions you might be asked
| Dialog | When | Your choices |
|---|---|---|
| Nothing in stock for this item | A supply request for something available nowhere you can draw from, or a transfer from a source that holds none of it. A table lists Requested and Available. | Back to the draft; Create transfer request (supply); Create purchase request; on a transfer with other lines, Buy these 2, send the rest or Buy everything instead. |
| Ahead of schedule | The location orders on a schedule and this is early. | Type a Reason for ordering ahead of schedule (required) and OK, or Cancel. |
| Above maximum stock level | An item would end up over the location's maximum. Tansi names the item and the numbers. | Type a Reason for ordering above the maximum and OK, or Cancel. |
| Double-check these quantities | Supply requests only: a quantity far above usual (an extra zero). Shows Why it stands out and the previous high. | Go back and fix or The quantities are right — submit. |
| Stock check | Purchase orders and transfers where a line is short or needs a look. | See The stock check. |
If you are not allowed to raise a transfer or a purchase request, there is no way round the shortfall from your side: Nothing is in stock for one of the items anywhere. Your draft is saved — change the items, or ask your warehouse or manager to source them.
Create transfer request and Create purchase request cancel this draft and carry every line over to the new one (SR-… cancelled; continue on TR-….). Buy these 2, send the rest keeps the transfer and puts only the missing items on a new draft purchase request, which you then finish and submit.
While it submits
For anything that takes more than a moment, a progress box shows numbered bubbles: Check, Stock (purchase orders and transfers), Route, Approvers, Save, Done, with a line saying what is happening (Finding who approves it…, Holding the stock it needs…, Letting the approvers know…) and a seconds counter. After 15 seconds it adds Still working. Long requests take longer; please keep this page open.
The result
- Submitted for approval — route: Supply to CST. It now waits for an approver.
- Submitted. No approval was needed.
- Submitted as 2 requests, one per category: … Your workspace keeps one category per request. The editor warned you before submit, and each part is approved and filled on its own.
- Also created: PO-… or Also submitted: … when linked requests went with it.
The stock check
The Stock check appears when you submit a purchase order or transfer and some line needs a decision. Approvers see the same dialog as Review sourcing on a supply request. Supply requests skip it at submit: sourcing is decided after approval.
Reading it
A summary line counts items need your decision, items not in the catalogue and items with enough stock. Lines needing a decision come first, each in an amber card:
- Item — requested 10 and a flag: Not enough stock: choose what to do or Check before you go on.
- On hand (or, on a transfer, Usable source stock) per location, with the total against what was asked: Main 4 · North 3 (7 of 10). Stock already at the receiving location is never used as a transfer source.
- Radio buttons with the options Tansi worked out for that line. Choosing one shows what it will do: From location North: with a quantity, Substitute … from location …, Order from vendor: with a supplier list and quantity, or Fill this line with … from this request's own source. A line under it gives the source and the reasoning.
When more than one line is short, Apply to all shortfalls offers Auto-fix where possible or Submit everything as-is, then Apply.
Lines not in the catalogue are listed but cannot be sourced: They stay on the request as they are; an approver links each to a catalogue item (or removes it) before it is picked or ordered. Lines with enough stock fold into a short list (Show all 12 when there are more than eight).
Leaving a shortfall unsourced
If you keep a short line as it is, an amber warning says how many lines go through without a sourcing plan, and the button changes:
| You are | Normal button | With a known shortfall |
|---|---|---|
| Submitting | Confirm and submit | Submit anyway with known shortfall |
| Approving (Review sourcing) | Apply sourcing plan | Apply anyway with known shortfall |
| Importing a file | Apply choice and create draft | Create draft anyway |
A request submitted with a known shortfall carries a banner on its page so the approver and warehouse plan for it: Submitted with known shortfall, or ⚠ Urgent request submitted with insufficient stock when it is Urgent.
Options that order or transfer stock create the linked purchase orders and transfers when you confirm. The success message lists them (Also created: PO-2026-0130.) and they appear under Linked requests on the original.
If the request changed while you were deciding, Tansi says The request changed while you were deciding — please retry. and nothing is submitted.
After you submit
Finishing a draft
A draft's page has Continue editing and, if you raised it, a Submit button that runs the same checks as the editor. Drafts are listed in My requests.
An administrator can open and save a draft someone else raised, but only the person who raised it can submit it. The editor says This draft was raised by … Only they can submit it for approval, and Submit is disabled with Only the person who raised this draft can submit it. Drafts Tansi created itself, such as a transfer raised from a supply request, can be submitted by anyone working the queue.
Recalling a pending request
While your request is pending and nobody has decided, Recall & edit appears on its page (also Recall to draft in the ⋮ menu). Tansi asks Recall this request from approval? It goes back to Draft, approvers are told, and you must submit it again. with Recall & edit or Keep waiting, then opens the editor.
Opening the editor address of a request that is no longer a draft shows This request is Pending approval and can no longer be edited. with a link back.
When an approver returns it
A request returned for clarification is a draft again. The approver's note is on the request and in the activity (Returned for clarification). Fix it and submit again; approval starts from the beginning.
The ⋮ menu
| Item | Shown to | What it does |
|---|---|---|
| Generate packing slip | People who fill transfers | Opens a PDF preview. |
| Generate purchase order | People who fill purchase orders | Opens a PDF preview. |
| Generate receiving report | People who receive or fill requests | Opens a PDF preview. |
| Duplicate | People allowed to raise that kind | Copies it into a new draft. |
| Save as template | People who manage templates | Saves its lines as a reusable template. |
| Recall to draft | The requester, while recall is possible | As above. |
| Cancel request | People allowed to cancel it at its stage | Asks for a Reason (required), then Request cancelled. |
The print icon next to the menu opens a preview of the whole request, from which you print or download.
Duplicate
Duplicate SR-… into a new Draft? Tick Bring attachments along (excludes vendor invoices) and optionally Override need-by date. Progress, approvals, and dates will be reset. Source will be linked as the origin. The new draft opens in the editor and its page says Duplicated from …. Completed and canceled requests also have a Duplicate icon on the hub and in the lists.
Save as template
Give a Template name (required) and an optional Description, then Save: Template saved.
Approving a request
When a request is waiting for you, its page opens with a panel: This request is waiting for your approval. Under it: the step number and how the step decides, the Ordering location and, if you may see costs, the Estimated total (or Estimated — 2 line(s) have no price).
Tansi checks stock, thresholds and pricing while the panel loads (Checking stock, thresholds, and pricing…). Problems are counted in one line, for example 2 line(s) can't be filled from stock · 1 line(s) drop below minimum at North Clinic, followed by a pointer to the fix.
The approval view of the items
While you are the approver, the Items table switches to Approval view. The usual allocated, ordered and received columns would all read zero before approval, so instead each line shows its quantity, a stock flag and, with costs, the line total:
| Flag | Meaning |
|---|---|
| In stock | Enough is available. |
| Short 4 | Not enough anywhere; 4 more are needed. |
| Below minimum after | Approving leaves the ordering location under its minimum. |
| Over maximum after | Approving takes it over its maximum. |
| Not in catalogue | An unlisted item. Link to catalogue item resolves it. |
Expand a line for Where the stock is (the ordering location marked), Products under this item for a generic item, Levels at … (minimum, reorder point, maximum, and whether they are set for this location or are the item default), After approval (the projected balance and why) and where the price came from.
The buttons
| Button | What it does |
|---|---|
| Approve | Asks for Approval notes (optional) and records your approval. If your workspace set a reminder for approvers, it shows above the box. |
| Adjust items | Trim quantities or remove lines without rejecting. See below. |
| Review sourcing | Supply requests, for approvers who also fill supply requests: raise the transfers and purchase orders now. Filled when a line needs a decision. |
| Reject | Requires a Rejection reason. The request ends as Rejected. |
| Return | Sends it back to Draft for clarification. Shown only when the step allows it. |
Adjust items
Adjust items before approving: Changes apply immediately and stay on this request — the approval you are working through is not restarted. Every change is logged against your name. For each line set an Approve quantity or tick Remove; warnings show when a line leaves the location below its minimum or over its maximum, and with costs you see the Revised estimated total. Add an optional Why, then Apply 2 change(s). You cannot remove every line: reject instead.
Review sourcing
This is the Stock check in approver mode: Purchase orders and transfers you create here are raised immediately; this request stays in approval so you can still approve, reject, or return it. Press Apply sourcing plan. The new requests go out for their own approval (Sourcing plan applied. Created: TR-…, PO-….), and you still make your decision on this one.
Return for clarification
The request will be sent back to Draft status so the submitter can edit and re-submit. The current approval instance is cancelled. Fill in What needs clarification? (required, up to 2000 characters); the requester sees it with the request. Press Return for clarification.
People with approval-bypass rights see Executive Override under Progress while a request is pending. It skips the remaining approval, needs a reason of at least 20 characters and the tick I understand this action is logged., and the step shows — as override with the reason on hover. Use it for genuine emergencies only.
A red box Couldn't check whether this request is yours to approve means the check itself failed. The approval buttons stay hidden until it works: reload the page, and quote the message to support if it keeps happening.
The Approval Inbox
Open it from the Approvals card or the Pending Approval counter on the hub, or Open queue on the Awaiting my approval panel. It needs the right to approve requests.
Approval Inbox — Requests waiting on your decision — transfers, purchases, and supply in one place. The refresh icon reloads it. When there is nothing: Inbox is empty.
| Column | What it shows |
|---|---|
| Request # | The number. |
| Type | Supply, Purchase, Transfer or Return. These are the built-in names, not your workspace's labels. |
| Requester | Who raised it. |
| Created | When it was created. |
| Priority | Low to Urgent. |
| Current step | Step number and how the step decides. |
| Actions | Open, Approve, Reject, and Return where the step allows it. |
Approve and Reject ask for notes exactly as on the request page: Approval notes (optional) when approving, a required Rejection reason when rejecting, and your workspace's approver reminder above the box if one is set. Return opens the same Return for clarification box. The list can be exported.
Where your approvals come from
A request lands in your inbox because a step on its approval route names you: by name, through a role, as the requester's designated approver or manager, through the spending authority (DOFA) table, as a controlled-substance approver or an approver for the items' categories, or as someone's delegate while they are away. A step marked (Any) leaves the inbox of everyone on it as soon as one person approves. The Approvals card on the hub carries a badge with how many are waiting, and the Awaiting my approval panel shows the newest five.
The inbox does not show stock, minimum and maximum levels or cost. For anything beyond the routine, press Open and approve from the request page, where Tansi shows what approving will do to stock and lets you adjust or source first.
If people say requests sit unapproved, the usual cause is a missing Designated Approver for the requester, or an approver who is away with no Delegation in place. Both are set in Request Settings and are quicker to fix than chasing individual requests.
Filling a supply request
Once a supply request is approved, it waits for whoever fills supply requests. It appears in their Supply Requests to fill panel on the hub and in the Supply Requests list. Its page shows Supply details:
| Field | What it shows |
|---|---|
| Destination | The location it is for. |
| Requested on behalf of | The person, if given. |
| Reason given | The requester's notes, or None — the requester left the notes empty. |
| Sourcing | Lines decided so far: 2 from stock · 1 bought in · 3 not decided. |
| Coverage | A bar and 4 of 12 units covered, or — nothing set aside yet. |
The sourcing buttons
Tansi works out which lines another location can supply and which nobody holds, and labels the buttons with the counts:
| Button | What it does |
|---|---|
| Create Transfer for 3 available items | Makes a draft transfer for what other locations hold, at the quantity they hold, and opens it so you can choose the source, resolve generic items and submit. |
| Create Purchase Order for 2 unavailable items | Makes a draft purchase order for what nobody holds and opens it to choose the supplier. If your workspace asks about contracts, Tansi asks which contract first (you may leave it blank). |
| Allocate from Stock | Sets stock aside straight away from a location you can issue from. |
| Edit items | Correct the request before anything is sent or ordered. |
| Mark Fulfilled | Shown when Tansi offers it for the request's state. |
| Receive | For older requests with lines ordered directly from outside. |
The transfer takes what other locations hold; the Purchase Order covers what no location has. You choose the source location or vendor on the next page. You can also expand a line in the Items table and use Create transfer or Create Purchase Order for that line alone, or tick several lines and press Create Purchase Order for 3 selected lines, for example the lines bought under one contract.
If Tansi cannot work out the stock picture for the request, the buttons appear without counts, as plain Create Transfer and Create Purchase Order. Each puts every open line on one draft and opens it, and you choose the source or supplier there.
The supply request completes on its own once the transfers and purchase orders that fill it are approved. Lines covered by a linked purchase order are hidden from its table, with a note saying how many.
Allocate from stock
- Pick the Line (each shows what remains).
- Pick From location: only places you can issue from that hold the item, closest first, with the quantity available.
- Enter the Quantity. The helper says the most you can take: what the line needs or what the location has.
- If that leaves some still needed, choose Leave the rest for now, Create a transfer for the rest or Create a Purchase Order for the rest.
- Press Allocate or Allocate and order the rest.
If no location you can issue from has the item, the dialog says so and offers the transfer and purchase buttons instead. If your role has no locations assigned, it says No source locations available to you, which an administrator fixes.
Edit items
Edit items on SR-…: Changes apply as soon as you save. They are logged on the request, and the requester is told what changed. Change a New quantity, tick Remove, or add catalog items with Add an item, Quantity and Add. Add a Note for the requester (optional) and press Save changes. Quantities must be more than zero; use Remove to take a line off.
If an action creates a purchase order directly, a Purchase order window opens on the spot (Draft created and linked to the supply request.) with Vendor, Need by (optional), and each line's Quantity, Unit price and Line total. Choose Leave as draft, Save draft or Submit; the order needs a vendor before it can be submitted.
Unlisted lines
A line marked Not in catalogue has Link item. Search for the catalog item and press Link item; the requester's wording is kept in the line notes. Items not allowed at the destination cannot be linked here. If the item does not exist yet, create it in the Item Master first.
Purchase orders after approval
An approved purchase order's page shows Purchase details: Supplier, Supplier location, Contact, Expected, Ship to, the contract, the external PO number, Sent to vendor, Vendor confirmed and any financial coding. The buttons depend on where the order is and on your rights.
| Button | What it does |
|---|---|
| Send to Vendor / Resend to Vendor | Also at the top of the page. Opens an email to the supplier with Subject (required) and Message body filled in, and any attachments tagged Quote to tick. Send emails it and moves the order to Active. With no supplier set, the order still moves on but the email cannot go. |
| Mark as Sent | You sent the order yourself (printed, faxed). Optional How was it sent?. Nothing is emailed; the order moves on to waiting for the supplier. |
| Assign External PO / Change External PO | Record the number from your finance system (up to 100 characters). Your workspace may rename this field. A changed number keeps the old one in the audit history. |
| Add Contract / Change Contract | Change the contract on an approved order. The change is recorded in this order's history, and the finance exports send the new number. |
| Add Financial Coding / Edit Financial Coding | Account, Cost Centre, Program, Location (financial) and Project. One distribution applies to every line. Fill empty fields from defaults uses the receiving location, the items' categories and suppliers, the supplier and Request Settings. Leave Account empty when lines belong to different accounts. |
| Record Vendor Confirmation | The supplier confirmed the order. |
| Update ETA | Change the Expected Delivery date and Save ETA. |
| Email AP | Only when accounts payable has an email set. Asks Send Purchase Order … to …?. |
| Send Receiving Confirmation | Emails the supplier what arrived. A line-by-line summary of received, damaged and missing quantities and the receiving-confirmation PDF are added automatically. |
| Receive / Receive items | Opens receiving for the lines still outstanding. |
| Close Purchase Order | Closes the order when Tansi offers it. |
Once sent, Download Purchase Order PDF gets the same document again for printing or forwarding.
Some orders are marked for the external PO route. The page then says that procurement places the order, so it is not sent from Tansi: raise the requisition from the purchase request export and record the external PO number here. After receiving, a second box reminds you to receive it in the finance system too so the supplier can be paid.
Shipments
The Shipments box tracks parcels. Its chip reads No shipments, Awaiting receipt (2), Partially received (1 of 2) or Received. Add shipment asks for Carrier, Tracking number, Estimated arrival, optional notes and a Time-sensitive (open immediately upon receipt) switch with a reason that shows on the receiving location's dashboard banner. Each shipment has a carrier tracking link, Mark received, and a remove icon until it ships.
Procurement timeline
On the right, Procurement timeline (folded by default) ticks off Draft created, Submitted for approval, Approved, External PO linked, Sent to vendor, Vendor confirmed, Shipments received, Invoice attached, Invoice verified, Sent to AP and Closed, each with when and who.
Totals after receiving
Under the lines, once anything is received, Received so far shows the items at receipt cost, fees read off the receipt, the Landed total, any Price variance against the order price line by line, and what is Still to receive. Order totals follow.
Transfers and returns after approval
A transfer's page shows Transfer details: From, To, Carrier, Tracking #, Shipped and Shipped by, Received and Received by. A return to the warehouse reads Returning from and Going back to.
Shipping
| Button | Who sees it | What it does |
|---|---|---|
| Pick & ship | Warehouse staff | Opens the warehouse work order, where the source lot is picked and the shipment recorded. |
| Send it back | On a return to the warehouse, for people at the returning location who do not fill transfers | Ships every line in one step. The status line explains: Pack the items, then press Send it back. They come off …'s stock when you send them, and … receives them. |
| Ship return | On a supplier return | Ships the lines back to the supplier. |
The ship dialog lists each line with Remaining, Ship now and Storage area. For lot-tracked items it fills the lots earliest-expiry first (Lots at source — FEFO suggested); edit the per-lot numbers or press Reset to FEFO. The lot total must equal Ship now. A pinned lot shows Locked to …; on returns quarantined and recalled lots are included, and handling one needs an acknowledgement. Pick the Carrier (set up under Carriers) and type the Tracking #. A scanner adds one to the matching line per scan.
Receiving
Once something has shipped, Receive items appears for people allowed to receive at that location, along with Attach proof of delivery. If someone else's team receives there, you see The team at … receives these items. You can't change stock there. Receiving itself is covered in Receiving stock.
Attach proof of delivery takes a signed slip (image or PDF, up to 20 MB) or Or capture a signature on screen, the Signer name (required) and optional notes, then Attach POD.
When every line is filled, a green box says All items received. with Mark request complete. It appears only once every line is filled or canceled, and a close attempted earlier is refused.
Returns on hold
Stock sent back from a station can wait at the warehouse for a decision: restock, dispose or send to the supplier. The return's page says 2 items are on hold at … until someone decides what happens to them, with a link to Returns on hold for warehouse staff.
Supplier returns
The Return Details panel shows the Original Purchase Order (linked), the external PO, Returning from, Ships to vendor with the branch, and RMA #, which reads Not issued — most vendors refuse delivery without one until you add it. Reasons chips count the lines by reason, such as Expired × 2.
Printing a return label
On an approved or active return to the warehouse, Print return label opens a 4×6 inch label with a Print button: RETURN TO SENDER, a return tracking number, From → To, the contents with quantities, and the request number.
The return tracking number is built from the print date and the request, so printing on another day gives a different number. The bars under it are decoration, not a scannable barcode. Every label carries the banner RETURN — QUARANTINED / EXPIRED whatever the actual reason, and the Lot column is always blank. Write the lot and the real reason on the carton if the receiver needs them.
Every request page also shows the Shipments box; on transfers the shipment the warehouse records at Pick & ship appears there automatically. Use Add shipment only for a separate parcel or to mark one time-sensitive.
Vendor invoices and matching
A purchase order's page has a Vendor invoices card. A purchase order can have many invoices, one per shipment or bill. With invoice matching switched on: Each invoice is matched to the PO and what was received before it is paid. Without it: Attach each invoice the vendor sends. Approving one pays what was received and not yet invoiced, at PO prices.
Attaching an invoice
- Press Attach invoice.
- Enter the Invoice number (required or optional, as your workspace sets it).
- Enter the Invoice date, the date printed on the invoice. It cannot be in the future; it goes to accounts payable in the payment file.
- Choose the scan of the invoice (required or optional).
- Press Attach invoice.
Invoice statuses and buttons
| Status | Meaning |
|---|---|
| Attached | Added, not yet matched. |
| Being matched | A matching draft is saved. |
| On hold | Nothing is paid until it is re-opened. |
| Waiting for approval | Accepting created something (a revision) that needs approval first. |
| Approved for payment | Ready for accounts payable. |
| Sent to AP | Handed to accounts payable. |
| Cancelled | Withdrawn. |
Each invoice shows its date, total, the amount to Pay now, any Debit memo, when it was approved and sent, and its scan. Buttons appear as they apply: Enter invoice / Continue matching, Approve for payment, Send to AP, Edit details (needs a reason), Hold, Re-open, Cancel invoice.
Matching
Enter invoice opens Match invoice …. Key the figures as the supplier printed them; leave a line blank when it is not on this invoice and a price blank when it is the PO price. Fill blanks with the expected figures copies in what Tansi expects.
- Lines: Ordered, Received, Already invoiced, To invoice and PO price, then your Invoice quantity and Invoice price, the Difference and a Decision for each difference.
- Extra costs: freight and fees on the PO against the invoice; Add a cost not on the PO.
- Taxes: calculated against keyed; Add a tax not listed.
- Total: Invoice total, as printed and the keyed total, with whether they agree.
To invoice is what was received and not yet invoiced (three-way match), or what was ordered and not yet invoiced (two-way match), depending on your workspace. Press Check, fix what it finds, then Accept. You can also Save draft or Hold. Some decisions, such as accepting a higher price, are marked Finance only.
If you received items on this purchase order, someone else has to accept its invoice: You can still key it and save a draft. A price revision you asked for must also be approved by someone else. People who cannot see costs cannot match invoices.
The rest of the card
- PO family: when an order was split or a supplemental order added, links to each member.
- Revision … is waiting for approval: a price change asked for while matching, with Approve and Reject.
- Received but not invoiced: what has arrived and not been billed, at PO price.
- Adjustments log: every attach, match, decision, hold, edit and return, with who, when and why.
- Financially complete. Everything is received, invoiced and sent to AP. or a list of what is still open.
Returns to the vendor and credit notes
Under the invoices, Returns to the vendor lists items sent back against this purchase order. The quantity comes off what was received, and the stock stays held until it is shipped back. This is the quick way for goods that arrived wrong on an order; a separate supplier Return request does the same job as its own request.
| Return to vendor (on the PO) | Supplier Return request (RTN-) | |
|---|---|---|
| Where | A card on the purchase order's page | Its own request, raised from New request |
| Approval | None: it starts at once | Goes through its approval route |
| Stock | Held where it is until marked shipped back | Leaves when the return is shipped |
| Best for | Something that arrived wrong on this order | Stock going back that needs sign-off, or several items from one order |
Only people who can receive on the order can start one; entering a credit note needs the right to fill purchase orders.
Starting a return
- Press Return to vendor.
- Choose the PO line (each shows how many were received).
- Enter the Quantity going back, up to what is received and not already going back.
- Pick the Reason: Wrong item, Damaged, Failed quality check, Expired or Other.
- Choose What the vendor does: Replacement (the quantity is open to receive again and the next delivery closes the return) or Credit (enter their credit note when it arrives; it lowers what is paid on this PO).
- Add the Vendor RA number (optional) and Why it is going back (required).
- Press Return to vendor: The return is started. The stock is held until it is shipped back.
Following it through
| Status | Next step |
|---|---|
| Requested | Mark it shipped back: optional Carrier and Tracking number, then Mark shipped back. The stock leaves now. |
| Shipped back | For a credit, enter the credit note. For a replacement, receive the new delivery. |
| Credit received / Replacement received | Done. |
| Cancelled | Withdrawn with Cancel return. |
Enter credit note opens Credit note for …. It shows the Expected credit (PO price and tax for the units returned) and asks for the Credit note number, date, Amount, including tax (as printed, without a minus sign), an optional scan and a Comment. Enter credit note sends it to accounts payable as a negative amount.
Reading a request page
Every kind of request uses the same two-column page. The left column holds what the request is for, its items and comments; the right column holds its progress and history.
The header
| Part | What it shows |
|---|---|
| Number and chips | The request number, its kind, its stage, its fulfillment state, Controlled when it carries restricted items, and its priority (with (overridden) if someone changed it). |
| Requested by | The requester of record. |
| Requested on behalf of | The person it is for, when given. |
| Delivery address | When one was entered (not on returns). |
| Need by | Or Not set. |
| Project | Or None. |
| Barcode and QR code | The barcode carries the request number for scanners; the QR code opens the request. |
| Print icon | Print preview of the whole request. |
Banners you may see
| Banner | Meaning |
|---|---|
| Raised from supply request SR-… · requested by … | This transfer or purchase order fills another request. Show supply request history unfolds that request's stage bar and activity, read-only. |
| Ordered together and submitted as 2 requests, one per category | Links to the other parts of a split order; this one is marked (this one). |
| Continued from … / Duplicated from … | Converted from another kind of draft, or copied. Show its history unfolds it. |
| Submitted with known shortfall | Some lines had no stock at submit. |
| Shipped … Carrier … Tracking … ETA … | The latest shipment, with Reprint packing slip. |
| Not-allowed item override on this request | Lines added against the destination's not-allowed list, with the reason, who and when. |
Right-hand panels
| Panel | What it holds |
|---|---|
| Progress | Route, approval steps and the milestones after approval. |
| Procurement timeline | Purchase orders only, folded. |
| Assignment | Who owns the work, with its history. Reassigning reloads the page. |
| Linked requests | The transfers and purchase orders filling this one, each with its stage, line count and first items. Status updates flow back here as each one progresses. |
| Recent activity | Every event: created, submitted, each step approved or rejected, picking, packing, shipping, receiving, discrepancies, proof of delivery, items changed, split by category, overrides, returns for clarification and more. A long history folds into one section per day (Today, Yesterday, then dates). |
| Attachments | Pick a Tag (Quote, PackingSlip, VendorInvoice, RmaDocument, Photo, RecallNotice, Other), then Upload one file: PDF, PNG, JPG, Word or Excel, up to your workspace's size limit. Each file can be opened, downloaded or deleted. |
| Custom fields | Values captured by your workspace's forms, or No custom field values captured for this request. |
The delete icon removes the file with no confirmation. Files tagged Quote are the ones offered when a purchase order is sent to the supplier.
Comments
Type in Add a comment (up to 4000 characters) and press Post. Everyone who can open the request sees it. Tansi also writes its own entries here, such as a note when reserved stock is recalled, and marks bypassed approvals with a Bypassed chip.
Finding requests
There are six lists, all opened from the hub:
| List | What it holds |
|---|---|
| My Requests | Two tables: Created by me, and Assigned to me / I've worked on (requests someone else started where you picked, packed, shipped, approved or commented). |
| All Requests | Every kind together. |
| Supply Requests | Supply Requests from the field. Adds a Requesting Location column. |
| Stock Transfers | Stock Transfers between locations. Adds Direction (Incoming, Outgoing or Within your sites) and From → To; each row expands to show its lines. |
| Purchase Orders | Purchase Orders sent to vendors. Shows Supplier. |
| Returns | Both kinds of return. Type reads To a supplier or To the warehouse. |
The header
- Scan icon: scan a request label to open it.
- Keyboard: the keyboard shortcuts (Tab, Enter to open or sort, Space, Esc).
- Export: download what is listed.
- Import CSV: Bulk import.
- New …: a new request of the list's kind, if you may raise it.
Filters
| Filter | What it does |
|---|---|
| Search or scan | Number, item, notes or barcode. Scan a label (or type at least four characters and press Enter) and a matching request opens directly. |
| Type | All types or one kind (not on the single-kind lists). |
| Stage | All stages, or Draft, Pending approval, Approved, Rejected, Active, Completed, Cancelled. |
| Priority | Any, or Low to Urgent. |
| Raised by | Anyone, or one requester (not on My Requests). |
| Site | Requests for one location. |
| Created from / Created to | A date range. |
| Critical line only | Requests with at least one critical item. |
| Assigned to me | Requests assigned to you. |
Active filters show as chips after Filtering by; close a chip to drop it, or press Clear all filters.
The columns
Request number (with a Controlled chip where it applies), Supplier, Direction and From → To, Type, Stage, Fulfillment, Priority, Requesting Location, Created, Need By, Requester, Assigned To, and a Duplicate icon for kinds you may raise. Columns appear where they mean something. Each column has its own filter menu, and you can sort by several columns at once. Click a row to open the request.
Empty results: No requests match your filters. On My Requests: You haven't created any requests that match these filters.
Every request page and printed document carries the request barcode. Scanning it on the hub or any list opens the request, which is the fastest way to find one from a packing slip.
Request templates
Open Templates from the hub's Manage group. You need the right to manage templates. Request Templates — Reusable starting points for purchase, transfer, and supply requests.
The list
| Column or icon | What it means |
|---|---|
| Name | With the description underneath. |
| Type | Supply, Purchase, Transfer or Return (built-in names). |
| Scope | Tenant (your workspace) or Global (shared across the platform). |
| Priority | Worked out from the lines. |
| Created by | Who made it. |
| Use template | Creates a draft from it and opens the editor: Created draft SR-… from template. |
| Order Set (PDF) | A printable order set of the template's items. |
| Edit | Your workspace's own templates. |
| Clone to my tenant | Global templates: copies it into your workspace and opens the copy. |
| Delete | After Are you sure you want to delete '…'? This action cannot be undone. |
Type filters the list. With none yet: No templates yet. and Create your first.
Making a template
The quickest way is from a request you have already placed: ⋮ › Save as template. To build one by hand, press New Template:
| Field | What to know |
|---|---|
| Name (required) | Up to 200 characters. |
| Priority (auto-derived from lines) | Read-only. |
| Description | Up to 1000 characters. |
| Type | Cannot be changed after the template is created. |
| Default need-by offset (days) | Days after the request is created to use as its need-by date. |
| Items | Add line: Item description, Quantity, Unit of measure, Priority. |
Press Save template.
Lines here are a description, quantity, unit and priority, with no catalog item picker. Saving a template in this editor stores only those four things, so a template saved from a request loses its links to catalog items when you edit and save it here. Location templates (Load template items on a supply request) skip lines with no catalog item. To change the items of such a template, raise a request with the right items and use Save as template instead.
Templates and locations
Templates can be linked to locations, one marked as the default, by an administrator. A supply request for that location then offers them in Request template, and Start from template on the New request page can filter by For location. A location can be set to accept only template items. The Order Schedule names the template a facility orders from.
Bulk import from a spreadsheet
Open Import CSV on the hub or a list, or Bulk import (CSV) on the New request page. You need the right to create requests.
Bulk import — Upload a CSV or Excel file to create a supply request with a line per item (one per category, if your workspace keeps requests to one category). Column names and order don't matter; Tansi matches them, checks every value, and shows you anything that needs a decision.
The import always makes supply requests. To bulk-load a purchase order or transfer, import a supply request and let the storeroom source it, or build the order with Browse catalogue in the editor.
Before you import
- Column names and order do not matter: Tansi matches them, checks every value and shows you anything that needs a decision before it creates anything.
- Keep the file to one order. Rows Tansi cannot use are left out and offered back to you as a file to fix and import again.
- If your workspace keeps one category per request, expect one draft per category.
After the file is read
- Draft SR-… created with 24 line(s), or 3 drafts created, one per category with a link to each.
- If some rows could not be used: 4 row(s) from your file weren't imported. Download them, fix them, and import that file again. with Download rows not imported.
- Tansi checks the ordering schedule and stock levels. If a draft is ahead of schedule or above a maximum, it asks for the reason there and then (the same questions as at submit).
- A summary says whether the drafts are within the location's schedule and limits.
Then choose
| Button | What it does |
|---|---|
| Submit for approval / Submit (or … all) | Shows your workspace's reminder, if any, and submits every draft: Request SR-… submitted. |
| Review the draft first | Opens the draft in the editor (one draft only). |
| Import another file | Starts again. |
If a submit fails, Tansi names the draft and the reason and says Open the draft to fix this, then submit from there.
Use cases: asking for stock
1. A site foreman needs harnesses (construction)
- On the hub, press New Request and type harness in Search item.
- Pick Safety harness, full body. Tansi shows Transfer from Yard (12 on hand) and Order from vendor. Not sure which, the foreman ignores both and presses Supply Request under I already know what I need.
- Requested for location is already North Site Office, because he is assigned to that site only.
- In Add an item by name or SKU he adds the harness, sets Qty to 6, and adds two lanyards with Browse catalogue.
- In Notes for the approver: Two new hires start Monday; scaffold work on level 3.
- He sets Need by and presses Submit for approval. Tansi answers Submitted for approval — route: Site supply.
The storeroom later fills it with a transfer from the yard; the foreman follows it under Linked requests and in My shipments on the hub.
2. An office restocks from a spreadsheet (office)
- The office manager exports her usual stationery order to a CSV: item, quantity, unit.
- On the hub she presses Import CSV, uploads the file and answers the questions the import raises.
- Tansi reports Draft SR-… created with 31 line(s) and that two rows were not imported. She presses Download rows not imported, sees two misspelled SKUs, and fixes them later.
- The order is a week early, so Tansi asks for a Reason for ordering ahead of schedule: Quarter-end mailing.
- She presses Review the draft first, adds the two missing items by hand, and submits from the editor.
3. A shared station login asks for dressings (clinic)
- At the nursing station, signed in on the shared station account, a nurse opens New Request › Supply Request.
- The location is filled in. Requested on behalf of is required on this account, so she picks herself from the people at this location.
- The location only accepts template items, so she picks the Weekly dressings template and presses Load template items. Tansi adds 14 lines.
- She types 100 for gauze by mistake. On submit, Double-check these quantities flags it against the previous high of 10; she presses Go back and fix, corrects it and submits again.
This example comes from a clinic, but requests work the same way for any kind of stock: building materials, office supplies, event equipment or warehouse parts.
Use cases: approving and filling
1. An approver trims an order (events)
An events company's venue store asks for 60 radios and 60 headsets for a weekend festival.
- The operations manager sees it in Awaiting my approval on the hub and presses Review.
- The approval panel shows 1 line(s) exceed the maximum. Expanding the headsets line, After approval shows the venue would hold 90 against a maximum of 70.
- She presses Adjust items, sets headsets to 40, writes Venue max is 70 in Why, and presses Apply 1 change(s).
- She presses Approve, adds Approved at 40 headsets, and confirms. The requester sees the change in Recent activity as Approver adjusted lines.
2. The storeroom fills it (warehouse)
- The storeroom lead opens Supply Requests to fill on the hub and picks the request (Not started).
- Coverage reads 0 of 100 units covered — nothing set aside yet.
- The main warehouse holds 30 radios. She presses Allocate from Stock, picks the radio line and Main Warehouse (30 available), enters 30, chooses Create a Purchase Order for the rest and presses Allocate and order the rest.
- Tansi allocates the 30 and opens a draft purchase order for the other 30, already linked. She picks the supplier and submits it.
- For the headsets, Create Transfer for 1 available item opens a draft transfer from the satellite store; she checks the source and submits it.
- The supply request now shows both under Linked requests, and completes on its own once they are approved.
3. A request comes back for clarification (office)
A branch asks for twelve office chairs with no reason given. The approver presses Return, writes Which rooms are these for? We have six in storage. in What needs clarification? and confirms. The request is a draft again; the requester reads the note, cuts the order to six, explains in Notes and submits. Approval starts again from the first step.
4. An unlisted item gets linked
A requester added Gaffer tape, 48 mm black with Item not in the catalogue. The approver presses Link to catalogue item in the approval view, finds Tape, cloth, 48 mm, black, and presses Link item. The requester's wording stays in the line notes, and the line can now be sourced.
Use cases: buying and sending back
1. Ordering lumber with freight (construction)
- Purchasing opens New Request › Purchase Order and presses Don't know the supplier? Search by item, finds 2x4 stud, 8 ft, and presses Use this supplier. The supplier and the first line are filled in.
- She adds three more items with Browse catalogue; the supplier's items are listed first.
- Under Extra costs she presses Add extra cost: Shipping / freight, Flatbed delivery, $180, taxable, with the provincial sales tax.
- She checks the Order total against the quote and presses Submit for approval. Her workspace asks about contracts, so No Contract yet appears; she ticks N/A — this order is not under a contract and presses Submit.
- Once approved, she presses Send to Vendor, attaches the quote and presses Send.
- The yard receives the delivery. When the invoice arrives, she presses Attach invoice, then Enter invoice, keys the figures, presses Check and then Accept. She did not receive the goods herself, so she may accept it. With the figures agreeing, accepting approves it for payment, and Send to AP hands it to accounts payable.
2. Wrong fittings go back to the supplier (warehouse)
- On the purchase order, under Returns to the vendor, the receiver presses Return to vendor.
- PO line: Elbow, 90°, ¾ in (50 received). Quantity going back: 50. Reason: Wrong item. What the vendor does: Replacement. RA number from the supplier's email.
- When the carrier collects the box, she presses Mark shipped back on the return and adds the tracking number.
- The replacement delivery is received against the same order and closes the return.
3. Expired stock goes back to the warehouse (events or clinic)
- At a satellite store, a coordinator opens New Request › Return and picks Back to the warehouse.
- Returning from is her store; Send it back to lists the warehouse that supplies it.
- She adds the items from what the store holds and sets each Reason to Expired.
- Once approved, she packs the box, presses Print return label, then Send it back. The stock leaves her store when she sends it, and the warehouse receives it.
This example comes from a clinic, but requests work the same way for any kind of stock: building materials, office supplies, event equipment or warehouse parts.
The Warehouse Queue
Once a supply request or a transfer is approved, somebody has to physically move the goods. That work lands on the Warehouse Queue — Pick, pack, and ship approved supply and transfer requests. It is the warehouse team's worklist.
You reach it from the Warehouse Queue card on the Requests hub. It is not in the side menu. You need permission to fulfill transfers; without it the page shows You don't have permission to access this page.
The queue is not a list of jobs assigned to you personally. It shows the approved supply and transfer requests at every location you are allowed to see. Two people with the same locations see the same queue. Use the Location filter to narrow it to your own warehouse.
Keeping it current
The page refreshes itself every 30 seconds (hover the sync icon to read Auto-refreshes every 30s). Refresh reloads it at once. The time of the last load shows as Updated with the clock time, at the right of the filter bar.
The tiles across the top
Colored tiles count the work, for example Open Work Orders, Picking In Progress, Ready to Ship, Overdue, Today's Shipments, returns pending and in transit, and restricted and critical work in the queue. The last tile counts time-sensitive shipments on their way: it reads Time-sensitive (all locations), or Time-sensitive Active once you pick a location. It turns red when the count is above zero. A banner under the tiles lists those shipments.
Filters
| Filter | What it does |
|---|---|
| All, Standard transfers, Returns, Critical, Restricted | Chips that narrow the Internal list to one kind of work: everything, transfers that are not returns, returns only, requests holding a critical item, or requests holding a restricted item. |
| Location | A searchable tree of your locations. Pick one place, or leave it on All locations. The tiles, the queue and the incoming list all follow it. |
| Min priority | Show only work at this priority or higher: Low, Normal, High or Urgent. |
| Stage | Show only work at one warehouse stage: Ready, Picking, Picked, Packing, Packed or Shipped. |
Internal — work at this location
The first list is the work your team does: supply requests and transfers to pick, pack and ship. Newest requests come first. Click a column heading with arrows to sort by it instead. Click a row to open the work order.
| Column | What it tells you |
|---|---|
| Request # | The request number. A small red dot means some lines are flagged at a higher priority than the request itself; hover it to read how many. |
| Date | When the request was raised. |
| Type, Priority, Stage | Chips for the request type, its priority and where it is in pick, pack and ship. |
| Need By | The date it is needed. Red when it is overdue. |
| From / To | Where the stock leaves from and where it goes. |
| Items | How many lines the request has. |
| Picked | Units picked so far out of the total, such as 0 / 240. |
Rows are tinted so trouble stands out: light red for overdue work that has not shipped, light orange for Urgent work. When the list is empty it reads Nothing in the outbound queue. Approved supply or transfer requests will appear here.
External — incoming from vendors
The second list is purchase orders that have gone to a vendor and are waiting to be received at one of your locations. A red chip counts the time-sensitive ones. The first column is named after your workspace's word for a purchase order (set in Request Settings), followed by #.
| Column | What it tells you |
|---|---|
| Vendor, Ship To | Who is sending it and which of your locations receives it. |
| Priority, Sent, ETA | The priority, the date it went to the vendor and the expected delivery date. The ETA turns red when it has passed. |
| Items | How many lines are on the order. |
| Shipments | A summary chip: gray when no shipment is recorded, amber when none has been received, blue when some have, green when all have. |
A clock icon beside the number marks a time-sensitive shipment; hover it to read why. Clicking a row opens the purchase order itself, where it is received. When nothing is expected the list says so and reminds you that internal transfers appear in the list above.
Both lists have an export menu that downloads the rows you are looking at, with your filters noted.
0 / 240 means none of the 240 units are picked yet. It is the quickest way to see how much of a job is left without opening it.
Working an order: picking
Clicking a row on the Warehouse Queue opens its work order. The header shows the request number, its type and priority chips, an Overdue chip when it is late, and a line with the need-by date, who requested it, and where it goes from and to. A step bar reads 1 Pick, 2 Pack, 3 Ship; the current step is filled in.
On the right (or below on narrow screens) the Activity panel lists the last 40 things that happened, newest first, with the time and the person. It reads No activity yet. on a fresh order.
Starting, and the pick claim
Press Start picking. The order is then yours: you see You are picking this order. Others cannot pick, pack or ship it until it ships or a supervisor releases it. Everyone else sees Being picked by your name and the time you started.
If a picker goes home with an order half done, a supervisor (someone with the sensitive level of the fulfill-transfer permission, or a workspace administrator) can press Release claim. Tansi asks Release this order? and explains that picks already recorded are kept. Release frees the order; Keep claim leaves it alone.
Where to pick from
Pick from (default) sets the location for every line at once (Applies to every line — override individually below if needed.). Each line also has its own Location box. Under it Tansi shows the full path, such as Main depot → Room 2 → Shelf B, and up to three exact spots holding the item with the quantity at each. View location opens Where to find followed by the item name. It repeats the location path and shows the floor plan with a Pick here pin, a Yard / site map, or both, when your workspace has set them up. With neither, it says No floorplan or yard map has been configured for this location yet. Follow the location path above to find the item. If the location has been removed, it says This location is no longer available. Close returns you to the order.
A location includes every shelf and bin under it, so Available counts all of that stock. If you choose a place outside the locations you are assigned to, the line reads Outside your assigned locations — you can't pick from here.
The lines table
| Column | What it is for |
|---|---|
| Item | Name, unit and handling chips. A Needs you flag appears here after Record all skips a line. |
| SKU / Barcode | To check against the shelf label. |
| Priority | The line's own priority. A warning at the top tells you to pick lines flagged above the request's priority first. |
| Requested / Picked | What was asked for and what is picked so far. Picked turns green when the line is complete. |
| Location and Lot | Where you are taking it from and, for lot-tracked items, which lot. See below. |
| Available | Stock at the chosen location. Amber when there is not enough; +N elsewhere shows stock at other locations. |
| Quantity | How many you are picking now. Only N available here warns you when you type more than the shelf holds. |
| Record / Reset | Record the pick, or discard this line's picks and start it again. |
Lots
For a lot-tracked item, the Lot box lists each lot at the location with its expiry and quantity on hand. Quarantined, suspended and recalled lots carry a colored chip. Tansi pre-selects a lot for you: the lot the request asked for, or else the one that expires first. The caption under the box says which. Check it against the box in your hand.
- Picking a different lot from the one requested asks you to confirm (Different lot than requested).
- If you never touched the lot box, recording asks Lot not confirmed and names the lot it will use.
- A lot that is not active (quarantined, suspended, recalled) shows a warning first.
- If the box is empty, Tansi explains why: no lotted stock at this location, or stock that was loaded without a lot number. That stock cannot be picked until its lot and expiry are recorded on the Lots page.
- On a return, quarantined and recalled lots are listed first, because that is usually what is going back.
Recording picks
Three ways, use whichever suits the job:
- Record on a line records the quantity, location and lot shown.
- Scan / enter barcode: scan an item and Tansi records one unit on the matching line. A GS1 barcode that carries a lot selects that lot. A camera button appears when your workspace has camera scanning turned on.
- Record all N ready lines records every line that is ready in one go. Lines that need a check are left for you and listed, each with a link that jumps to it and a reason, such as choose where to pick it from, only 4 available at this location, or restricted item. Use its own Record button to read the warning. If some lines would use a lot you have not confirmed, Check the lots lets you record them all, skip them, or cancel.
Record stays grayed out until the line has a location, a quantity above zero that the location can supply, and (for lot-tracked items) a lot. Restricted and high-risk items show a warning before the pick is recorded, and that warning is written to the audit log.
Picked the wrong lot or quantity? Reset asks Reset this line? and discards that line's picks. Nothing has left stock yet, so this is safe.
Finishing the pick
Print pick list opens a printable list in a new tab, handy for a long order. When every line is picked, press Complete picking. You see Picking complete. Ready to pack.
The Available hints say the rest of a short line can be sourced via a transfer request at end of picking, but Complete picking stays grayed out until every line's picked quantity reaches what was requested. If a location cannot cover a line, pick the rest from another location using that line's Location box. If the stock does not exist anywhere, talk to whoever approved the request.
Packing and shipping
When picking is complete, the work order moves to Pack. It says how many lines were picked and explains the idea: Tick the items going into one box or bag and add it; keep adding containers until everything is packed. Each container gets its own slip ("Box 1 of 3"). Shipping everything in a single package? Just mark packed.
Packing into containers
- Read the status line, for example 0 of 36 units packed.
- In the table, tick the items going into this container (the top tick box selects them all). Each row shows the item and lot, how many were Picked and how many are Remaining to pack.
- Adjust Qty in this box if only part of a line goes in this container. It starts at the remaining quantity.
- Choose the Container type and, if useful, add Container notes (optional) such as keep cold, fragile (up to 500 characters).
- Press Add followed by the container type and number, for example Add box 1. Tansi confirms that the container is packed.
- Repeat until Everything picked is packed. Print the slips and mark packed.
Each container gets a card listing its contents, with Print slip and Remove. Removing a container asks first: its contents go back to the list to be packed again, the containers after it are renumbered, and you should reprint any slips you already printed.
Package notes (optional) (up to 1,000 characters) is for the shipment as a whole, for example 1 box, fragile; loaded on dock 3. Print all slips prints one slip per container; with no containers the button reads Print packing slip.
Press Mark packed. If you used containers, everything picked must be in one first. You see Packed and ready to ship.
Going back to picking
Back to picking is on the Pack and Ship cards, for when a count was wrong or stock must come from somewhere else. Your recorded picks are kept. If you had packed containers, they are emptied, because the picks they came from may change; you pack again afterward. Tansi asks Back to picking? first, and confirms Picking reopened. Recorded picks are kept. Once an order has shipped you cannot go back.
Shipping
| Field | What to enter |
|---|---|
| Carrier | Required. Chosen from your workspace's Carriers list, so the shipping record links to a real carrier and the requester gets a working tracking link. If no carriers exist, shipping is blocked until an administrator adds one. |
| Tracking number (optional) | The carrier's tracking or waybill number. |
| ETA | When it should arrive. |
Press Ship and notify requester. You see Shipment recorded; requester notified. The card then shows Shipped via the carrier, the tracking number and the ETA, with View transfer and Reprint packing slip.
If other transfers on the same route have not shipped yet, Tansi asks Travelling together? and lists them. Copy carrier details puts the same carrier and tracking number on them; No, separate shipment leaves them alone.
Whether a short order may ship is set on the approval workflow, not here. If the workflow has a Pick it in the warehouse step with Part shipments allowed switched off, shipping is refused while lines are short. See Step kinds and who a step lands on.
Receiving against a request
Goods that arrive for a request are booked in from the request itself. Open the purchase order, transfer or return and press Receive items (green). It appears when you may receive and lines are still outstanding. The receive panel takes the place of the lines table until you confirm or cancel.
Receiving stock with no request behind it (Scan & Receive, Exceptional receipts) is covered in Receiving stock.
Where it is landing
If the request has no receiving location yet, a yellow box says No receiving location on this request and Pick where these items are landing — inventory won't update until you do. Choose Receive at. The box then reads Receiving at the selected location.
The toolbar
| Control | What it does |
|---|---|
| Apply picks | Only when the warehouse recorded picks (transfers). Fills each line's quantity, lot number and expiry from what was picked. You can still edit every line. |
| Receive all | Fills each ticked line with its full outstanding quantity. |
| Scan box | Scan barcode or SKU… then Enter. Each scan adds one unit to the matching line; a chip confirms, for example +1 qty Gloves, or says Unknown. |
| POD | Attach proof of delivery: photos or PDFs, up to 20 files. On a phone it opens the camera. The number in brackets counts files attached. |
| x of y lines filled | Progress. |
| N need attention · Next | Appears when lines are incomplete; each press jumps to the next one. Show only these hides the finished lines. |
| Cancel / Confirm receipt | Leave without saving, or book the receipt in. Confirm needs a receiving location and at least one ticked line with a quantity. |
Each line
Every line is a card with a tick box, the item and SKU, a Picked chip when the warehouse picked it, and the Outstanding quantity. Its left edge is gray when nothing is entered, amber for a partial receipt, green when complete and red when anything is damaged. Untick a line to leave it out of this receipt.
| Field | What it is for |
|---|---|
| Receive (unit) | How many good units arrived. Cannot exceed the outstanding quantity. The unit is the item's own, or its container (such as packages). |
| Damaged (unit) | How many arrived damaged. |
| Reason | Required when you receive less than outstanding or record any damage: Damaged, Short shipped, Missing, Wrong item, Failed quality check, Expired or Other. |
| Note | Anything else worth recording. |
| ⊕ / ⊖ | Add another discrepancy adds a second row for the same line, for example 2 damaged and 3 missing with different reasons. |
| Put away into | The exact spot inside the receiving location (fridge, shelf), when the location has spots. Storage area (optional) picks an area instead. |
Lot details
Items that track lots, expiry, serial numbers or custom tracking fields get a Lot details box. A counter shows lot quantities entered against the quantity received; they must match; until they do, the box reads, for example, Lot total (4) must equal received (6). Add another lot splits a line across lots.
- Lot #: type it, or on a picked transfer choose from the lots that were shipped. If a different lot turned up, choose A different lot arrived…, type it, and say why. It is recorded as a discrepancy.
- Expiry: required when marked *. It is locked when it comes from the shipped lot.
- Serial # and the item's own tracking fields, when the item uses them.
- A lot number Tansi has never seen for this item shows a warning: check the label.
Purchase orders also have a Receipt paperwork box (optional) for the Packing slip / invoice # and any extra cost on it, such as freight. Each line has Unit cost on receipt; if it differs from the order price, the variance is shown and recorded.
Confirming
Confirm receipt checks everything first. Anything missing is listed on the card as Still needs: (a lot number, an expiry date, where it is stored, a reason for the short or damaged quantity, and so on) and Tansi jumps to it. Warnings for restricted or high-risk items and inactive lots come next, then any lot whose expiry differs from the one already on file. When it goes through you see, for example, Received 24 units across 3 line(s). Stock rises at the receiving location, line statuses move to Partly filled or Filled, discrepancies are written to the request's comments and the requester is notified.
Closing a request that will never be complete
When every line is filled on a purchase order, transfer or return that is not yet completed, a green bar reads All items received. with Mark request complete. The dialog explains that closing marks every remaining open line as Fulfilled, moves the request to Completed, and stops tracking outstanding quantities. Type a Reason (audited) (up to 500 characters); it is saved as a [CLOSED] comment. Press Mark complete.
The dialog describes closing a request that is still short, such as a transfer that shipped short or a supplier who will not deliver the rest. On screen, though, the button only appears once every line already counts as filled. If you need to close a request that is still short, ask your administrator.
Use cases: warehouse and receiving step by step
1. Construction: tools to a site, picked by scanner
- A site supervisor's transfer for drills, blades and safety glasses is approved. It appears on the Warehouse Queue in the Internal list at Ready.
- The storekeeper filters Location to the yard, opens the order and presses Start picking. The order is now locked to them.
- They set Pick from (default) to the tool crib and scan each item with a handheld scanner. Each scan records one unit; the Picked column climbs.
- Blades are short at the crib: Available is amber and shows +20 elsewhere. They change that line's Location to the yard container that holds them and record the rest.
- Complete picking, then Mark packed (one load, no containers).
- On Ship, they choose the company truck from Carrier, set the ETA to tomorrow and press Ship and notify requester.
2. Events: a conference kit in four boxes
- An event coordinator's supply request for badges, lanyards, extension cords and signage is approved.
- The warehouse picks every line with Record all 12 ready lines. One line is left with Needs you: choose where to pick it from; they set its location and press Record.
- On Pack they tick badges and lanyards and press Add box 1, then cords in box 2, signage in boxes 3 and 4, adding Container notes "fragile" to the signage.
- Print all slips prints "Box 1 of 4" to "Box 4 of 4". Then Mark packed and ship with the courier's tracking number.
3. Office: a vendor delivery with a short line
- Paper, toner and chairs arrive for a purchase order. Reception opens it from the External list and presses Receive items.
- In Receipt paperwork they type the packing slip number and add the freight charge with Add extra cost.
- Receive all fills every line. The vendor sent 4 chairs of 6, so they change chairs to 4 and pick Short shipped as the reason.
- They photograph the signed delivery note with POD, then press Confirm receipt.
- The chairs stay outstanding. When the last two arrive, the same steps book them in.
4. Health care: restocking a clinic with lot-tracked stock
- A transfer of vaccine and syringes to a clinic is picked at the depot. The vaccine is lot-tracked: the picker checks the pre-selected lot (earliest expiry) against the box, confirms it and records.
- The vaccine is packed in a cooler box with Container notes "keep cold" and shipped.
- At the clinic, the nurse opens the transfer, presses Receive items and then Apply picks: quantities, lots and expiry dates fill in from the pick.
- One box is cracked. They lower Receive by one, enter 1 in Damaged, choose Damaged as the reason, pick the fridge in Put away into and confirm.
Some wording on these screens comes from health-care customers (medication, controlled substances, cold chain). The features themselves work the same for any stock: tools, parts, office supplies, event kit or building materials.
Stock Levels: the Stock & Assets page
Stock › Stock Levels opens a page titled Stock & Assets, with the line Inventory quantities and asset tracking across all locations. The time after Updated tells you when the numbers were last read. The same page also opens from Maintenance › Reports › Inventory.
The page has two tabs: Stock Levels for consumable stock and Assets for tracked equipment. Each tab name shows how many rows it holds.
The three quantities
| Column | What it means |
|---|---|
| On Hand | Everything physically in your locations. |
| Reserved | The part of on hand already promised: held for an approved request, or held because it was received without a purchase order number. |
| Available | What you can actually use. It shows in red when it is zero or less. |
If on hand says 4,585 and reserved says 60, you have 4,525 to work with. Promising the full 4,585 to someone else is how you end up short.
The status chip
| Status | When it shows |
|---|---|
| Unavailable | Something is on hand, but nothing is available: it is all reserved or held. |
| Out of Stock | Nothing on hand and nothing available. |
| Low Stock | Available is at or below the item's reorder threshold. |
| In Stock | Anything else. |
The line at the bottom counts Items, With Stock, Low Stock and Unavailable / Out of Stock for the rows you are looking at.
The action buttons
The buttons in the header depend on your rights. Someone who only withdraws supplies sees none of them.
| Button | What it does | Who sees it |
|---|---|---|
| Withdraw Supplies | Opens the withdraw page. If your workspace renamed that page (many clinics call it Dispense), the button carries the new name. | Editors of stock tracking |
| Reorder Suggestions (N) | Opens Reorder Suggestions. N counts items that are out of stock or at or below their reorder threshold. The button is hidden when N is zero. | Editors of stock tracking |
| Receive against request | Find an open request by number, or scan its docket, and receive it. See Inbound deliveries and receiving against a request. | Editors of stock tracking |
| Exceptional receipts | The queue of deliveries received without a Tansi purchase order or transfer. | Editors of stock tracking |
| Move stock | Move stock between storage spots inside one location, at once. | Editors of stock tracking, and anyone allowed to move stock |
| Transfer | Starts a new transfer request to another location. | Editors who may raise transfers |
| Adjust | Correct a quantity, with a reason. | Editors of stock tracking |
Filters
| Filter | What it does |
|---|---|
| Search | Item name, SKU, description or lot. The list updates when you finish typing and press Enter, not on every key. |
| Category | One category. |
| Department | Only appears when the listed items belong to departments. No department finds items that have none. |
| Location | A searchable tree. Choosing a place includes everything stored inside it. |
| Stock | All items, In stock or Zero stock. Zero stock finds items with nothing on hand anywhere, the ones a site has never received or needs to order. |
| Flags | All items, Controlled (items marked restricted), Critical or Hazardous. |
| Refresh | Reads the numbers again. |
| Stock Ledger | Opens the full movement history. |
Your filters, page size, page and tab are remembered while you work, so opening an item and coming back finds the same rows. The export menu above the table downloads the rows you are looking at, with your filters written on the file.
The stock link on an item's own page opens this list filtered to that item, with the banner Showing stock for ... only. and its locations already open. Use Back to item to return, or Clear filter to see everything. This filtered view is not remembered.
When a generic parent item and its child products are both in the list, the children are shown only under the parent, so the same stock is not counted twice. Expand the parent to see them.
Stock Levels: locations, lots and assets
Opening a row
Select the arrow beside an item's name. What opens depends on the item:
- A normal item opens Stock by Location & Lot: one line per place and lot.
- A generic parent item (the chip says how many child items it has) opens Child items of ...: each product under it with its own On Hand, Reserved, Available and Locations. Each child opens its own location table. A parent is never stocked itself; its totals are the sum of its children.
Selecting anywhere else on the row opens the Lots page for that item.
Stock by Location & Lot
| Column | What it shows |
|---|---|
| Location | The path to the place, shortened if long; hover for the full path. A storage area such as a shelf or bin shows underneath. |
| Lot | The lot number and exp date (red once expired). A dash means the item is not lot-tracked. |
| SKU | The full SKU, wrapped rather than cut off. |
| On Hand, Reserved, Available | For that place and lot. |
| Updated | When that line last changed. |
| Lot chip | Means |
|---|---|
| Quarantined | Held back pending investigation. |
| Recalled | Withdrawn by the manufacturer or a regulator. |
| Suspended | Temporarily not to be used. |
A quarantined, recalled, suspended or expired lot shows 0 available on its line, whatever is on hand. Hover the number for the reason, for example Lot expired on 2026-08-31 and is not available for use.
Items that hold more than one dose
For these items the quantity headings name the unit, because a bare 6,000 can be misread as 6,000 vials when it means 6,000 doses. One extra column appears:
- Uses (× 100 per bottle) for items counted in whole units: available times the uses in each unit.
- ≈ vials (1 vial = 10 doses) for items counted in doses: roughly how many containers the available doses make.
The row icons
| Icon (tooltip) | What it does | Who sees it |
|---|---|---|
| Create purchase request | Starts a purchase request for this item. Red when out of stock, amber when low. | Only on out-of-stock or low rows, for people who may raise purchase requests |
| This item has alternative items available | Opens Alternatives for .... | Items with alternatives set |
| View item | A quick-view panel with the item's details. Its own buttons follow your Item Master rights. | Everyone |
| Edit item | Opens the item for editing. | Item Master editors |
Alternatives for ... lists each alternative with Priority, SKU, Notes, On Hand, Available and a Stock Status of Out of Stock, Low Stock or In Stock, with a small table of stock by location under each. If none are active it says No active alternative items available.
The Assets tab
| Column | What it shows |
|---|---|
| Item, SKU, Asset Code, Serial #, Category, Location | Identification and where it is. |
| Status | Online (green), Offline (red), Standby (amber) or DoNotTrack. |
| Criticality | Critical, Important or Normal. |
| Last Serviced, Next Service | Next Service turns red with a warning icon once it is overdue. |
Selecting an asset opens its maintenance record when it is linked to one, otherwise the item. The footer counts Total Assets, Linked to Maintenance and, when any exist, Overdue Service.
The Department, Location, Stock and Flags filters apply to the Stock Levels tab only.
Reserved Stock
Stock › Reserved Stock lists every stock row currently held for an open request or for a receipt waiting for its purchase order number, and what is holding it. Stock is reserved when a supply or transfer request is approved, and released when it is issued or canceled.
Wherever this manual says External PO, your screen shows your workspace's own name for the finance system's purchase order number, for example PeopleSoft PO.
The four figures
| Figure | What it counts |
|---|---|
| Reserved rows | Item × location × lot rows with something held. |
| Units reserved | The total held. |
| Items affected | Distinct items. |
| No identifiable holder | Rows where no open request or waiting receipt explains the hold (likely left by a closed request). Select the figure to list only those. |
The figures follow your filters, so narrowing to one site narrows the numbers too.
Filters
- Search: item, SKU, lot, location, request number or requester.
- Location.
- Only rows with no holder.
- An item chip appears when you arrive from an item's N reserved link; close it to see everything.
- Clear, Refresh and Export CSV.
Reading a row
Each row shows Item, Location (with its path and storage area), Lot, On hand, Reserved, Available, Held for and Updated. Held for shows up to two request chips (number and requester; hover for type, stage and quantity) and +N more, plus:
| Chip | Means |
|---|---|
| Awaiting External PO | Received without a purchase order number and held until one is added. |
| N unexplained | Reserved units no open request accounts for. |
| No open request | Nothing explains the hold at all. |
Expand a row to see each holding request (Request, Type, Status, Requested, Requester, Need by, Open; a substitute chip marks a substitute line) and each waiting receipt (Receipt, Received, Received by, Why no External PO, Quantity).
Beside a waiting receipt, Add External PO & release opens the same dialog as the Exceptional receipts queue. People who cannot release see Someone who receives purchases can release it. Adding the number releases every line of that delivery.
For a row with no holder the page explains: This is most likely a hold left behind by a request that has since closed. Review the item's stock at this location and adjust if the hold is stale. Work through Only rows with no holder regularly and ask whoever manages stock to correct them, because stock held by nothing is stock nobody can use.
Critical Items
Stock › Critical Items covers items that must never run out, and restricted items. An item appears here once it is flagged critical or restricted on its item record.
Figures and filters
Each figure at the top is also a filter. Select it to narrow the list:
- Critical & restricted items (the name follows the flag filter), across your locations or at the selected one.
- Stocked out, Below minimum, Below reorder.
- Expiring within 30 days.
Below the search (Item name, SKU, supplier...) and Location, two rows of chips filter further: Flag: All, Critical, Restricted, and Status: All, Stocked out, Below minimum, Below reorder, OK, each with a count.
Columns
| Column | Shows |
|---|---|
| Status | Stocked out, Below minimum, Below reorder or OK. |
| Item | Picture, SKU, unit, category, and chips saying why it is listed: Critical, Restricted, or Family of N for a generic parent. |
| On hand | Total across locations, with what is available and held. |
| Min / Reorder / Max | The thresholds, with a fill bar. A pin icon means Per-location thresholds apply. No thresholds set warns you there is nothing to measure against. |
| Days of cover | How long the stock lasts at average daily use: red under 7 days, amber under 14. no usage means nothing was issued in the usage window. |
| On order | Quantity on open purchase orders and how many. nothing on order in amber when the item is short. |
| Soonest expiry | The first lot to expire, expired N days ago, expires today, expires tomorrow or in N days. |
| Supplier | Who to call, with the lead time. An info icon means no preferred supplier is set and the first configured supplier is shown. No supplier in amber. |
| Locations | How many places hold it. |
Each row's menu offers Open item, Stock by location, Reorder suggestions and, for editors allowed to raise purchase requests, New purchase request. The header has Refresh, Export CSV and Reorder Suggestions.
If the page says No items are flagged critical or restricted, mark the items that must never run out on their item records (Open Item Master). Set minimum and reorder levels too, or the page cannot tell you when they are short.
Some wording on these screens comes from health-care customers (vials, doses, controlled items). The features work the same for any stock: tools, parts, office supplies, event kit or building materials.
Stock Review
Stock › Stock Review collects negative stock, held stock that was taken, and count variances flagged from the Tansi Inventory app: the mobile app staff use on the floor. Each flag is a question for a manager: why did this happen?
The three kinds of flag
| Kind | Raised when |
|---|---|
| Negative stock | A movement took a place below zero. |
| Held stock taken | Someone took stock that was reserved. The Held for link under the reference opens Reserved Stock. |
| Count variance | A counted line differed from what was expected by more than the thresholds below. |
Filters and columns
Filter by Type, Status (Open, Resolved, All) and Location. The grid, titled Flags (N), shows Type, Item, Location (with storage area), Lot, Quantity, Expected, Counted, Reference, Raised by, Raised and Status. A resolved flag shows who resolved it and when; hover for the note. The export menu downloads the flags you see, with storage area, resolver and note. When nothing fits the filters the grid says No flags match these filters.
Resolving a flag
- Select Resolve on an open flag.
- In Resolve flag, write a Resolution note: Say what you found or did. It is required, up to 1,000 characters.
- Select Mark resolved. Tansi says Flag resolved.
The note is a record of your decision. If the stock really is wrong, correct it with an adjustment or a count as well.
Count variance thresholds
Users with the higher level of rights on this page also see Count variance thresholds: A counted line is flagged when its variance is larger than both the percentage of the expected quantity and the unit amount below. Set Variance percent (0 to 100) and Variance units, then Save thresholds. Tansi says Thresholds saved., or Percent must be between 0 and 100, and units cannot be negative. if a value is out of range.
For example, with 10 % and 5 units, a line expected at 200 and counted at 192 is not flagged (8 is more than 5 units but less than 10 % of 200). Counted at 170, it is.
Move Stock
Move Stock is for the everyday shuffle: from the back shelf to the fridge, from a bin to a cart. It is immediate, with no request or approval. Moving stock to a different location is a transfer request instead, which has its own approval.
You can open it three ways: Move Stock in the always-shown part of the menu (a page of its own), Move stock on Stock Levels, or from Location Management. The dialog version has a Cancel button; the page does not.
Moving has its own permission, separate from editing stock levels. A site user can be allowed to restock carts without also being able to adjust or write off stock. Where they may move stock to is still limited to the locations they can write to. Without the right the page says You don't have permission to move stock.
1 · Choose location and destination
Pick the single location in From location. Only places that can hold stock are offered. Everything after this happens between the storage spots inside it.
2 · Items to move
- Type in Item (it reads Search items stocked here…) and select Add item. Only items with stock somewhere inside the location are offered; inactive ones say (Inactive).
- Browse items opens the catalog picker to add many at once.
- Scan or type a barcode in Scan or type a barcode…. A scan adds the item, or adds 1 to a line that is already there. The camera button appears only where your workspace has camera scanning turned on.
- If you pick a generic item, Tansi uses the one product under it that is stocked here, or asks which.
Each item becomes a line that opens to two choices:
| Part of the line | What to do |
|---|---|
| Coming from | Where the item sits now. One place is selected for you; several say Held in N places — choose which one. Each spot shows how many are on hand. |
| Going to | The other storage spots that can receive it, with N already on hand or currently empty. One spot is selected for you. More than six turn into a search box (Type a rack, shelf or area…) with one-click shortcuts under Already holds this item:. Spots that already hold the item come first, and numbers sort as numbers, so Shelf 2 comes before Shelf 10. |
| Quantity | For items without lots, a number on the line, up to what is at the source. |
| Lots to move | For lot- or expiry-tracked items, a table of lots (Lot, Expiry, On hand, Qty to use). Choosing an expired lot asks for a Reason for issuing from expired lot. |
The line's status reads, for example, Shelf 1 → Bin 2 in green once complete, or Choose source, Choose destination, No stock to move or No destination available in amber. Remove drops the line.
No other storage spot available here means the location has no shelves, bins or fridges set up to hold stock. Turn storage on for them in Location Management first.
3 · Confirm the move
Stock moves as soon as you confirm — there is no approval step to undo it. Add an optional Reason / notes (up to 1,000 characters) and select Move stock. While something is unfinished, a hint says N of M item(s) still need attention.
- Success: Moved N items.
- If something fails part-way, the lines already moved stay moved: N item(s) were moved before the error.
- Restricted or high-risk items, and lots that are quarantined, recalled or suspended, show a warning you must Acknowledge before continuing. Each acknowledgment is written to the audit log.
Adjusting stock and storage areas
An adjustment says the system was wrong and someone corrected it. Use Adjust on Stock Levels (Scan & Receive has the same dialog) when a quantity does not match reality. For something that existed and was lost, record waste instead.
The Adjust Stock dialog
| Field | What to enter |
|---|---|
| Scan / Enter Barcode | Optional. A scan picks the item; a GS1 barcode that carries a lot also picks the lot. Tansi says Found: .... |
| Item | Required. Generic parent items are not offered: adjust the product itself. Inactive items appear only for people allowed to work down inactive stock. |
| Location | Required. |
| Storage Area (optional) | For example Shelf A or Bin 3. |
| Adjustment Quantity | Positive to increase, negative to decrease. |
| Lots | For lot-tracked items: increasing asks for one Lot; decreasing shows the lot table, filled first-expiring first, with Reset to FEFO and a running Total against the quantity. |
| Reason (required for adjustments) | Up to 1,000 characters. |
Select Apply Adjustment. Tansi confirms Stock increased by N for ... or Stock decreased by N for .... Restricted and high-risk items ask you to acknowledge a warning first, and the acknowledgment is audited.
Every adjustment lands in the stock ledger and the audit log with a name against it. Frequent adjustments on the same item usually mean a process problem, not a counting problem. Breakage written off as an adjustment hides a real cost: record it as waste.
Record Waste: the same dialog in waste mode
On Waste Management, Record waste › Single item (dialog) opens this dialog titled Record Waste. The quantity becomes Quantity wasted (Enter the quantity to remove from usable stock), and instead of a reason you choose a required Waste reason and optional Details. On a shared account a required Recorded for asks who is recording it. See Waste Management.
Assigning a storage area
On an item's own page in the Item Master, each stock placement row has a pencil, Assign a new storage area (free text). It opens Assign storage area:
- It shows the location, lot and how much is available, and the Current spot (or Unassigned).
- Type or pick the New storage area (Cabinet, drawer, fridge shelf…) and select Move here.
- Only the available quantity moves. Reserved units stay where they are, and the dialog says so. If everything is reserved: Nothing is available to move on this row — all quantity is reserved.
- It is recorded in the ledger as a move with the reason Storage area assignment.
- Tansi confirms Moved N to ... (or to Unassigned if you cleared the area). Move here stays grayed out until you choose a different area.
Inventory Count: counting
Stock › Inventory Count: Scan items to verify stock levels. Differences are shown for review before applying adjustments. Nothing changes until you choose to apply.
There is no saved count to come back to. Leaving the page, Cancel or Clear All discards the counted figures. Cancel asks first: The quantities counted so far will be lost. No stock adjustments have been applied.
Starting
- Pick one or more places in Count locations. Each pick counts itself and everything stored under it: a site, its rooms and their shelves.
- Tansi loads every stock row there straight away: Loaded N stock row(s). If stock moves while you count, select Reload Expected Stock.
- Walk the shelves. Scan in Scan item barcode, or type the number in each line's Counted box.
Each scan adds 1 to the counted figure (+1 → 5 × gauze, lot A12). A barcode that carries a lot counts against that lot. An item that was not expected is added as a new line. Restricted items and held lots ask you to acknowledge a warning when scanned.
The count grid
| Column | What it shows |
|---|---|
| Item | With the place under it when the count covers several. |
| SKU | |
| Lot / Expiry | One lot, or 3 lots · 2 locations for an item held in several. Those rows open into a line per lot and place; they start open. |
| On Hand | The total across all locations, colored when below the minimum, at the reorder point or over the maximum. Hover for which. |
| Levels | min, max and thr (reorder threshold) for the counted place or the site it sits in. |
| Expected | On hand at the counted place when the count was loaded. |
| Counted | What you found. Whole numbers. Blank means not counted yet. |
| Difference | Green for over, red for short. A dash means nothing entered. |
| Reason | Why it differs. Required on every line that will be adjusted. |
Use Group by storage location when the count covers several places, and Expand all / Collapse all for items with many lots. The footer keeps score: Counted, Matched, Over, Short and, when relevant, Zero counts held.
A blank line is skipped, because nobody has looked at that shelf yet. Applying blanks would write a whole location down to nothing. Even a line you type as 0 is held back unless you turn on Include zero counts.
Some wording on these screens comes from health-care customers (vials, doses, controlled items). The features work the same for any stock: tools, parts, office supplies, event kit or building materials.
Inventory Count: applying and lot actions
Reasons
Pick a reason on each line, or set a Default reason in the header for any line without its own.
| Reason | Use it for |
|---|---|
| Miscount | The last count was wrong. |
| Data entry error | Someone typed the wrong figure. |
| Unrecorded receipt | Stock arrived but was never booked in. |
| Unrecorded issue / usage | Stock was used but never withdrawn in Tansi. |
| Damaged | Broken stock found. Also recorded as waste, reason Damaged. |
| Expired | Expired stock removed. Also recorded as waste, reason Expired. |
| Lost or stolen | Gone without explanation. |
| Found | More than expected turned up. |
| Transfer not recorded | Stock was moved without a transfer or move. |
| Other | Anything else. |
Applying
- Turn on Include zero counts only if lines you counted as 0 really should be written down to zero.
- Check Apply Adjustments (N). N is the lines that will change. If the button is grayed out, hover it: Enter a counted quantity on at least one line., Every counted line matches its expected quantity. or N lines to adjust have no reason.
- Select it. The confirmation reads, for example, 3 adjustment(s) will be posted: 1 increase(s), 2 write-down(s) of which 1 to zero. Each posts an Adjustment transaction that cannot be undone from this page.
- Select Apply. Tansi says Applied N adjustment(s) successfully. or, if some fail, Applied N, failed N. First error — ...
Each adjustment goes into the stock ledger with the reason, the expected and the counted figure, for example Inventory count adjustment [Miscount]: expected 24, counted 21.
Anyone with stock-tracking access can open the page and count. Applying needs edit rights on stock tracking or on stock counts. Counts done in the Tansi Inventory mobile app are flagged for review on Stock Review when they differ by more than the thresholds set there.
Lot actions during a count
Each line's menu offers:
| Menu item | What it does |
|---|---|
| Mark quarantined, Mark recalled, Mark suspended | For lot-tracked lines, editors only. Opens the lot status dialog. Afterward a message offers Create return to the warehouse this location orders from. |
| Return to warehouse | For people allowed to raise returns: starts a return transfer for that line, pointed at the warehouse this location orders from. |
| Remove from count | Drops the line from this count. |
The Stock Ledger
Warehouse › Transaction History, the Stock Ledger button on Stock Levels, and the Stock ledger links on the withdraw and waste pages all open the Stock Ledger: the complete audit trail of stock received, issued, adjusted, and transferred. When someone asks where did that go, this is the answer.
Filters
Choose Item, Transaction Type, Location, From Date and To Date, then Search. Clear resets them. Back to Stock Levels returns to the stock list.
If you pick a generic parent item, Tansi explains that it never has movements of its own and shows the combined ledger of its child items, each row naming its child.
The figures
Stock In, Stock Out and Net Movement total the rows you see. The fourth figure is Transactions, or Closing Balance once you pick an item.
Columns
| Column | What it shows |
|---|---|
| Date | When it happened. |
| Type | Receive (green), Issue (amber), Transfer (blue), Adjustment (gray) and other types. |
| Item | With SKU, and Child of ... for a product under a generic item. |
| Lot | |
| In, Out | The quantity in or out. |
| Balance | The running balance after this row, for the item and location you filtered on. |
| Movement | From where to where. External / origin means it came from outside; Issued / consumed means it left stock. |
| Recorded by | The person who did it. |
| Reason | Hover for the full text: count reasons, waste reasons, who a withdrawal was for. |
| Reference | The transaction's reference number. |
Rows that removed stock from a location carry an icon, Report an incident linked to this stock removal, which opens a new safety incident already linked to that movement. Useful for a theft, a spill or a dose given in error.
The footer reads Showing the complete matching ledger · N transaction(s), and the export menu downloads the rows with from and to storage areas.
Withdraw Supplies: the page
For most people in an organization this is the only page in the module they will ever use. Withdraw Supplies sits in the always-shown part of the menu. You scan or tap the supplies and say who received them; the operator and time are captured automatically.
Your workspace can give this page its own name — many clinics call it Dispense. The new name shows in the menu, on the page and on the buttons that open it; the address, permissions and records stay the same. Set it under Requests › Admin › Request Settings. Withdraw for Delivery can be renamed the same way. Withdrawing needs edit rights on withdrawals; without them the page says You don't have permission to record inventory withdrawals.
The examples on this page (gauze, a nurse, a clinic fridge) come from health care, and many clinics rename the page Dispense. Neither the page nor dispensing is limited to medical use: a site office handing out safety gloves, a warehouse issuing tape and labels, or an events team giving out radios works exactly the same way.
The header shows the page name, the working location and Operator with your name. On the right are Scan (the device camera, where your workspace has camera scanning turned on) and Stock ledger.
The working bar
| Field | What it does |
|---|---|
| Working location | Where you are taking supplies from. It opens as a tree, so a site folds open to its rooms, shelves and fridges. Choosing a place includes everything stored inside it, and Tansi remembers it on that device. |
| User account | The account doing the withdrawal: yours by default, or a shared station account (marked Shared account). People assigned to the working location are listed first. |
| Withdrawing for | The name of the person taking the supplies, up to 200 characters. Its tag says Optional on your own account and Required on a shared account, because the login alone does not say who took them. Use it too for someone with no Tansi account. |
Either way you are recorded as the operator, with the time, so the trail always says who handed the supplies over. On a shared account Tansi refuses to withdraw, dispense, give doses or record waste until the name is filled in: ... is a shared account: fill in Withdrawing for with who is taking the supplies.
If the location has storage areas, chips above the list filter to All areas or one area, each with its product count. Until you pick a location the page says Choose your working location.
What counts as available here
The list shows stock in the location and everything inside it, from lots that are active and not expired, with something available. Quarantined, recalled and suspended lots never appear, and neither do assets.
The three tabs
| Tab | What it shows |
|---|---|
| Available supplies | Everything usable at this location, with a count. |
| Dispensing | Every multi-dose unit that has been opened, each with its own clock. See Dispensing: opening a unit and its clock. |
| Waste | Everything thrown away here, why, and whether a person or the expiry clock recorded it. See The Waste tab. |
Beside the tabs, the Open now panel lists every open unit, soonest to expire first, on every tab — so a clock running out is never out of sight. Below it, Recent activity shows the last eight withdrawals at the location (2 × gauze · For J. Smith · recorded by ...) with a link, See the full stock ledger.
Finding a supply
- Search or scan — type a name, SKU, barcode or lot. Pressing Enter treats the text as a barcode: a match opens the withdraw dialog straight away, with the pack quantity the barcode stands for. No match? No item matched that barcode. The text is still available as a search.
- Category and Show — narrow to Multi-dose only, Expiring within 90 days or Low stock (below the minimum or at the reorder point that applies at this location). Reset clears them.
- A line under the toolbar sums up the location: how many products show, how many hold more than one dose, and how many lots need attention (no lot number, no expiry, or expiring within 90 days).
Four views
| View | What you get |
|---|---|
| Cards | A tile per product: picture, storage and critical flags, how many are available, and a line naming the recommended lot and its days left. Press that line for the lot sheet. A generic item lists the products under it, each with its own Withdraw. |
| Grid | Product, SKU, Category, Available, Recommended lot, Doses (10 per vial, 6 h once opened, or single), Actions. |
| Kanban | A column per category with product and on-hand counts; fold a column by its heading. |
| Lot numbers | Every lot, first to expire first, with Lot, Product, Where, On hand, Expires and Time left. Lots with no lot number or no expiry are listed first, because nobody can rotate, recall or write them off on time. Hide lots with no lot number or no expiry hides them. |
Days left are green, amber within 90 days and red once expired. In the lot view an expired row reads expired — do not use and its Withdraw is grayed out; within 90 days it says use this one first.
The lot sheet lists every lot of one product held here, with the recommended one marked, its place, on hand, expiry (not recorded when missing) and time left, and a line explaining why that lot is recommended.
Withdrawing an item
- Choose the Working location, and the account and name if they are not you.
- Find the supply and select Withdraw. A generic item opens to the products under it — pick the one you are holding. A scan skips this, because the barcode already names the product.
- If the item is restricted or high-risk, read the warning and select Acknowledge.
- In Withdraw ..., check Lot (called Taking from when the product sits in more than one place, so the choice names the bin or shelf too). The recommended lot is the one with the earliest expiry (first expired, first out), marked ★ Recommended.
- Enter How many — whole numbers, at least one, no more than that lot holds in that place.
- Read the summary — 3 would be left here, 41 across this location — and select Withdraw.
Tansi confirms, for example, 2 gauze withdrawn from lot A12 in Fridge 2. The time and your name are recorded for you, and the line appears under Recent activity.
Messages you may see
| Message | Means |
|---|---|
| At least one is needed | The quantity is zero or blank. |
| Only N left on lot X in Y | Take the rest from another lot or place. |
| The only lot held at this location. | Nothing to choose. |
| Nothing here has an expiry date recorded, so nothing can be recommended on expiry. | The first lot held is chosen. |
| ... N more lots have no expiry recorded and cannot be ranked. | Undated lots go to the bottom of the list. |
| Withdrawal was not recorded: ... | Something stopped it; nothing was taken. |
If you choose a lot other than the recommended one, Tansi tells you what that means in an amber Not the recommended lot. banner — for example This lot expires 40 days later than the recommended one ... Taking this one first is how that one becomes waste. — and the confirmation names the lot you skipped. That is not a mistake: sometimes the recommended box is at the back of a fridge.
Some wording on these screens comes from health-care customers (vials, doses, controlled items). The features work the same for any stock: tools, parts, office supplies, event kit or building materials.
Items that hold more than one dose
Many supplies are not used up in one go. A vial holds ten doses of vaccine, a bottle holds 100 tablets, a box holds 12 cans. Tansi handles these on the item itself, in the Item Master, in the card Packaging, Storage & Stock. There are two ways to set an item up, and the choice decides what your stock is counted in.
These are often called items with multiples: one container on the shelf holds several doses or uses, and Tansi can count, dispense and expire them dose by dose.
The examples here are mostly clinical, because vials and tablets show the clock best. Dispensing is not limited to medical use. It works for any supply that is used a little at a time: a drum of cleaning concentrate, a box of 200 gloves, a spool of cable, a case of drinks for an event, a tin of paint once the lid is off. Read dose as one use and vial as container.
The two set-ups
| Contains multiple units — ON | Contains multiple units — OFF, uses above 1 | |
|---|---|---|
| Also called | Container mode | Uses mode |
| Stock is counted in | The doses or units inside — a vial of 10 counts as 10 | Whole units on the shelf — a bottle counts as 1 |
| Receiving is entered in | Containers (vials, boxes) — Tansi multiplies | Whole units |
| Fields | Container name, Units / uses per container, Expires after opening (hours), Generate a barcode for each received container | Uses / doses per unit |
| Opening one | Starts its in-use clock. Doses given come out of stock. | Takes one whole unit out of stock. Doses given are tracked on the opened unit only. |
| Expiry after opening | Yes — the hours you set | No — the clock runs to the lot's expiry date |
| Each container tracked | Yes, with its own barcode if you choose | Only once opened |
| Typical for | Multi-dose vials, items that spoil once opened, anything you count by the dose | Bottles of tablets, tubes, boxes of swabs counted as boxes |
The Expires after opening (hours) field only exists when Contains multiple units is on. Turning the switch off clears it. If a medication must be discarded a set time after the seal is broken, it has to be set up in container mode.
Setting up container mode
- Open the item in Item Master and go to Packaging, Storage & Stock.
- Turn on Contains multiple units.
- Enter the Container name in the singular — vial, box, package. It is the word Tansi uses on every screen (Open one vial).
- Enter Units / uses per container — how many doses one container holds.
- If it must be used within a set time once opened, enter Expires after opening (hours) — for example 6 for a vaccine that must be used within six hours of puncture, or 672 for 28 days.
- Leave Generate a barcode for each received container ticked to label every container on receipt, so each vial can be scanned and traced.
- Save.
Setting up uses mode
Leave Contains multiple units off and enter Uses / doses per unit — 100 for a bottle of 100, 200 for a box of 200. Leave it at 1 for single-use items. Stock stays in whole units; the number tells Tansi how many doses to track once a unit is opened, and powers the Uses figure on stock screens.
How these items behave elsewhere
| Where | What changes |
|---|---|
| Receiving | In container mode you receive vials or boxes; Tansi books the doses inside into stock and, if chosen, gives each container its own barcode. |
| Item Master list | A child item shows 10 per vial (container mode) or 100 uses per unit (uses mode). |
| Stock Levels | The location table names the unit in its headings and adds a Uses or ≈ vials column. |
| Withdraw Supplies | The Dispense button is enabled. Cards show how many doses a container holds, and the grid shows the hours allowed once opened. |
| Scanning | A container barcode identifies that exact container. |
A barcode can be recorded as a single unit or a package / case. Scanning a package-level barcode counts as a whole package's worth in screens that add up scans.
Dispensing: opening a unit and its clock
On Withdraw Supplies (or Dispense, if your workspace renamed it), a product that holds more than one dose has a Dispense button beside Withdraw. Withdraw takes stock off the shelf. Dispense opens one unit so you can give doses from it over time.
The examples here are mostly clinical, because vials and tablets show the clock best. Dispensing is not limited to medical use. It works for any supply that is used a little at a time: a drum of cleaning concentrate, a box of 200 gloves, a spool of cable, a case of drinks for an event, a tin of paint once the lid is off. Read dose as one use and vial as container.
Hover over it for the reason. Either this product is not recorded as holding multiple doses — set it up as shown in Items that hold more than one dose — or nothing here can be opened.
Opening a unit
- Select Dispense on the product. A generic item first asks which product. A dialog titled Open one … appears.
- Read the blue banner: how many doses the product holds and, if set, how many hours it must be used within.
- Check Lot (or Taking from when it is stored in more than one place). Each choice says how many are sealed or on the shelf. The lot that expires first is chosen for you; choosing another is allowed and recorded.
- Read the summary: how many doses become available, the box expiry, and when the in-use clock runs out — Anything still in it at 3:00 PM has to be discarded.
- Select Open it. The unit appears on the Dispensing tab and in the Open now panel with its clock running.
In container mode, opening a container starts its clock and its doses become available. In uses mode, opening takes one whole unit off the shelf, and its doses are tracked on the unit from then on. If there is no usable stock at all, the dialog says Nothing here can be opened.
If the stock predates container tracking there is no tracked sealed container. Tansi says so and opening it starts tracking one now: the container you physically open becomes the unit on the Dispensing tab, with its clock running.
Which clock is it on?
Each open unit carries its own countdown timer — on screen it is called the unit's clock or in-use clock. Every open unit counts down to whichever comes first:
| Clock | Set by | What happens when it runs out |
|---|---|---|
| In-use window | Expires after opening (hours) on the item, starting when the unit is opened | Dispensing stops, and the doses left are written off automatically as waste, reason Expired after opening. |
| Product (lot) expiry | The expiry date of the lot you opened | Dispensing stops. Record the doses left as waste yourself, reason Expired. |
| No clock | Neither is recorded | The unit has no countdown. Record an expiry on the lot if it should have one. |
The dialog shows both dates before you open — for example, Its box expiry is June 30, 2027 — a different clock from the one that starts now.
Reading the Dispensing tab
Every unit that has been opened and still has doses in it. Each card shows the product, lot, where it is, the box expiry, when it was opened, a large countdown, and Holds, Used and Left with a bar.
| Chip on the card | Means |
|---|---|
| In use | Seven days or more left, or no clock. |
| Expires this week | Less than seven days left. |
| Use it or lose it | Less than 24 hours left. |
| Expired | The clock has run out. Dispensing is blocked. |
Sort with Order — Soonest to expire first, Fewest doses left first or Product name — and filter with Show: Everything open, Still usable or Expired only. The countdown updates every second. With nothing open the tab says Nothing is open.
Every open unit is also listed in the Open now panel beside the tabs, soonest first, on every tab, with N of M left and its countdown (or no clock). Select one to jump to its card on the Dispensing tab.
Giving doses and recording waste
The examples here are mostly clinical, because vials and tablets show the clock best. Dispensing is not limited to medical use. It works for any supply that is used a little at a time: a drum of cleaning concentrate, a box of 200 gloves, a spool of cable, a case of drinks for an event, a tin of paint once the lid is off. Read dose as one use and vial as container.
Dispensing doses
- On the Dispensing tab, find the unit and select Dispense doses.
- Check the banner: the time left on the unit and when it closes.
- Enter Doses given. One person can need more than one dose, so this takes a number. The help line shows how many are left in the unit.
- Choose Given to from the list of accounts. It starts on the account in the working bar and must be filled in.
- Add a Note if useful (up to 300 characters).
- Check the summary — how many would be left — and select Record the doses.
The Given to field says it plainly: avoid patient names or health information. Record who received the supply in the way your organization's privacy policy allows.
- You cannot give more than the unit holds. Tansi says That is more than this unit holds. Open a second unit for the rest.
- When the last dose is given the unit is empty, closes and comes off the countdown list.
- On a shared station account, Withdrawing for must be filled in first, and that name is recorded with the doses.
- You stay recorded as the operator either way.
An expired unit's Dispense doses button is grayed out, and opening the dialog on a unit that expires while you watch shows This unit expired ... ago. Nothing further can be given from it. Record every dose at the time you give it.
Recording waste
Doses get lost — a drawn-up dose is dropped, a vial is cracked, a fridge fails. Select Waste on the unit's card. Because doses can be lost for more than one reason at once, the dialog Record waste — ... takes as many lines as you need.
- Enter the number of Doses on the first line.
- Choose a Reason and add an optional Note (up to 300 characters).
- Select Add another reason for a second line if some were lost differently. Remove drops a line.
- Check the total — 3 doses across 2 reasons, leaving 5 in the unit.
- Select Record the waste.
If something is missing Tansi lists it: Line 2 needs a dose count, Line 2 needs a reason, or That is 9 doses and only 5 are left in the unit. The Waste button stays available on an expired unit that still has doses, until the clock's own write-off has been recorded.
| Reasons you can choose | |
|---|---|
| Expired | The product itself passed its expiry date. |
| Cold chain / temperature excursion | Stored outside its temperature range. |
| Damaged | Broken, cracked, punctured. |
| Spoiled | Gone off and no longer usable. |
| Recall | Withdrawn by the manufacturer or a regulator. |
| Quarantined | Held back pending investigation. |
| Contaminated | Contaminated before or during use. |
| Discarded | Thrown away by choice. |
| Other | Anything else — explain in the note. |
That reason is written only by the expiry clock. If the product's own date has passed, choose Expired.
The Waste tab
The Waste tab on Withdraw Supplies shows everything that was thrown away, why, and whether a person recorded it or the expiry clock did, for the working location. It can always be viewed, even after a unit has expired and can no longer be dispensed from.
The examples here are mostly clinical, because vials and tablets show the clock best. Dispensing is not limited to medical use. It works for any supply that is used a little at a time: a drum of cleaning concentrate, a box of 200 gloves, a spool of cable, a case of drinks for an event, a tin of paint once the lid is off. Read dose as one use and vial as container.
The four figures
| Figure | What it counts |
|---|---|
| Doses discarded | All doses written off here, and how many entries. |
| Lost to expiry | Doses written off by the clock, and how many of the entries that is. |
| Recorded by a person | Doses somebody recorded. |
| Commonest reason | By number of doses. |
Filters
- Reason — All reasons or one, including Expired after opening.
- Recorded by — Anyone, and the clock, The clock or A person.
- Search — product, lot or note.
- Reset clears them; Export downloads the entries shown as a spreadsheet file (When, Product, SKU, Lot, Doses, Reason, Recorded by, Note, Reference).
The list
Columns are When, Product (with the note), Lot, Doses, Reason, Recorded by — a name, or The expiry clock recorded automatically — and View. The footer totals the doses shown.
View opens Waste entry — ...: Written by the expiry clock. or Recorded by a person., with Product, SKU, Lot, Doses, Reason, Recorded, Recorded by, Note and Reference.
Automatic entries cannot be deleted. The screen and the entry suggest that if doses were actually given before the unit expired, you can record them against the unit to shrink the write-off. In practice that is not possible once the unit has expired: Dispense doses is disabled and the remaining doses are recorded as waste. Record every dose at the time you give it.
With nothing recorded the tab says Nothing has been wasted here yet. Waste arrives two ways: somebody records it against an open unit, or a unit expires and the clock records it for them.
When the clock runs out
When an open unit's clock reaches zero, its card turns red, the chip reads Expired, and a line reads Dispensing is blocked. What happens next depends on which clock ran out.
The examples here are mostly clinical, because vials and tablets show the clock best. Dispensing is not limited to medical use. It works for any supply that is used a little at a time: a drum of cleaning concentrate, a box of 200 gloves, a spool of cable, a case of drinks for an event, a tin of paint once the lid is off. Read dose as one use and vial as container.
| Which clock ran out | What Tansi does | What you do |
|---|---|---|
| In-use window | Writes the doses left off as waste automatically, reason Expired after opening, recorded by The expiry clock. The entry appears on the Waste tab. | Nothing — then physically discard the unit. |
| Product (lot) expiry | Blocks dispensing: The product itself has expired. Record the doses left as waste. | Select Waste and record the doses left, reason Expired, then discard the unit. |
| Nothing was left | Closes the unit. There is nothing to write off. | Nothing. |
The automatic write-off runs every hour, so for up to an hour the card may read … doses will be written off automatically, or record the waste now. You can record it yourself straight away; either way it is counted once.
Once a unit has expired, Dispense doses is disabled and the remaining doses are recorded as waste. Doses cannot be added to an expired unit afterward, and waste written by the clock cannot be deleted. It stays on the Waste tab, where anyone can select View to see the entry.
Expired and emptied units stay visible on the Dispensing tab with their outcome for up to 48 hours, so you can see what happened, rather than vanishing.
Use cases: dispensing step by step
Three of these examples are clinical and two are not. The same steps apply to any supply that holds several uses — swap the vial for a drum of cleaning concentrate or a box of gloves and nothing else changes.
The examples here are mostly clinical, because vials and tablets show the clock best. Dispensing is not limited to medical use. It works for any supply that is used a little at a time: a drum of cleaning concentrate, a box of 200 gloves, a spool of cable, a case of drinks for an event, a tin of paint once the lid is off. Read dose as one use and vial as container.
1 · A multi-dose vaccine vial, used within 6 hours
A clinic stocks a vaccine in vials of 10 doses that must be used within six hours of puncture.
- Set up once. In Item Master, turn on Contains multiple units: container name vial, 10 uses per container, expires after opening 6 hours, barcode per container ticked.
- Receive. A delivery of 20 vials is received as 20 vials; 200 doses go into stock, each vial with its own barcode.
- Open. At 9:00 a.m. the nurse opens Withdraw Supplies (or Dispense), picks the clinic fridge as the working location, and selects Dispense on the vaccine. Tansi picks the vial from the lot that expires first and shows that the clock will run out at 3:00 p.m. She selects Open it.
- Give doses. Each time a dose is given she selects Dispense doses, enters 1, chooses Given to and records it. The card counts down Used and Left.
- A dose is dropped. She selects Waste, enters 1, reason Damaged, note dropped while drawing up.
- The clock nears zero. At 2:00 p.m. the chip changes to Use it or lose it and the unit sits at the top of the Open now panel.
- Time runs out. At 3:00 p.m. three doses are still in the vial. Dispensing is blocked; within the hour Tansi writes the three doses off as Expired after opening, recorded by the expiry clock. She discards the vial.
The Waste tab's Lost to expiry figure shows how many doses the clock threw away. If it is high, open vials closer to when patients arrive, or schedule clinics so each vial is used up within its window.
2 · A bottle of 100 tablets, counted in bottles
A pharmacy cupboard stocks acetaminophen in bottles of 100. Stock is counted in bottles.
- Set up once. Leave Contains multiple units off and set Uses / doses per unit to 100.
- Open. Select Dispense. One whole bottle comes off the shelf — stock drops by one bottle — and its 100 tablets are tracked on the opened bottle.
- Give doses. Select Dispense doses and enter 2 for a two-tablet dose. Stock does not change; the bottle's Left count does.
- The bottle's lot expires. The clock runs to the lot's expiry date. When it passes, dispensing is blocked; select Waste and record what is left, reason Expired.
3 · A box of 12 that does not expire once opened
An events team stocks drinks in boxes of 12 and wants to count them by the can.
- Turn on Contains multiple units: container name box, 12 per container, and leave Expires after opening empty.
- Receive boxes; stock is counted in cans.
- Use Withdraw to take cans, or Dispense to open a box and give from it. With no window and no lot expiry, the open box has no clock.
4 · A shared station account at a busy clinic
- The clinic signs in once on a shared station account.
- Each person enters their own name in Withdrawing for before withdrawing — Tansi will not let a shared account withdraw, dispense or record waste without it.
- When dispensing doses, Given to records the recipient; the operator is still captured.
5 · A janitorial closet: a drum of floor cleaner
A facilities team buys floor cleaner concentrate in 20-liter drums and wants to know how many mop buckets each drum fills.
- Turn on Contains multiple units: container name drum, 80 uses per container (one use is one bucket), and Expires after opening 2160 hours (90 days, the shelf life once opened).
- When a drum is started, the caretaker selects Dispense on it at the closet location.
- Each night shift records Dispense doses for the buckets mixed, Given to the night crew's account.
- A spill is recorded with Waste, reason Damaged. If the drum is not finished in 90 days, the clock writes off what is left and the manager sees it under Lost to expiry.
6 · Checking what the clock wrote off
- At the end of the week the clinic lead opens the Waste tab for the clinic fridge.
- She sets Recorded by to The clock to see only the doses lost to expiry.
- She selects View on an entry to see the product, lot, doses, reason Expired after opening and when it was written off.
- Expired units cannot be dispensed from and their waste cannot be deleted, so the lesson is for staff to record every dose at the time it is given.
Withdraw for Delivery: the list
Warehouse › Withdraw for Delivery is for stock sent to a department or place with nobody on the system to receive it. A department without Tansi emails the warehouse a request; the warehouse types it in, prints a pick list, records the shipment (which is when the stock comes off the warehouse), and later records the delivery confirmation, any discrepancy and the paperwork.
This page has its own permission, separate from Withdraw Supplies, so site staff keep their withdraw page and only warehouse staff see this one. Seeing a withdrawal also needs sight of the warehouse it leaves from; changing one needs edit rights and write access to that warehouse. Without the permission the page says You don't have permission to view delivery withdrawals. The page name can be changed in Request Settings.
When to use it, and when not
| Situation | Use |
|---|---|
| A department with no Tansi users asks for supplies by email | Withdraw for Delivery |
| A site that receives its own stock in Tansi needs supplies | A transfer request, so the stock lands in their stock when they receive it |
| Someone takes supplies off the shelf in person | Withdraw Supplies |
Statuses
| Status | Means | Next step shown |
|---|---|---|
| Draft | Typed in, saved. No stock taken yet. | Pick, then record the shipment |
| Shipped | The shipment is recorded and the stock has left the warehouse. | Confirm the delivery |
| Delivered | The department confirmed it arrived. | Review and close, or Resolve the discrepancy, then close |
| Closed | Finished; kept with its documents for audit. Cannot be changed. | — |
| Cancelled | Canceled before shipping. No stock was taken. | — |
A red Discrepancy chip sits beside the status of any withdrawal with a recorded problem that is not closed yet.
Finding a withdrawal
- Status chips across the top, each with its count: All, Open (not closed or canceled), Draft, Shipped, Delivered, Closed, Cancelled. The list starts on All, newest first, because closed withdrawals are the history people look up.
- Search: number, place, requester, tracking number, department, reference, the warehouse or who created it.
Columns: Number, Status, Deliver to, From, Items, Requested by, Created by, Created, Shipped and Next. Select a row to open it in a full-width panel. Editors see New withdrawal in the header.
The page was built for a central health warehouse supplying community programs, but it fits any team that ships to people outside Tansi: a head office sending stationery to a satellite office, a contractor's yard sending materials to a client's site, an events store sending kits to a venue.
Withdraw for Delivery: drafting and shipping
Select New withdrawal. The panel's title reads New — Withdraw for Delivery, with the hint Enter the emailed request and its items. Saving takes no stock. A progress line across the top shows Draft · Shipped · Delivered · Closed.
The three cards
| Card | Fields |
|---|---|
| Sent from | Warehouse (required). Stock stored anywhere inside it counts: shelves, bins, fridges. Notes (optional), Printed on the withdrawal report. |
| The request as emailed | Requested by, Department (from your workspace list; you can add one), Email, Phone, Request received (date), Email subject or reference. |
| Deliver to required | Choose A department — pick the Department, and optionally a Ship-To from the finance system's delivery points (search by code, name or address), which fills in the address — or A place on the system, which fills in its name and address. Then Attention (optional) and the Delivery address. |
Once saved, the cards fold into a one-line route — From Central Warehouse → To Housing Department — with Edit details to open them again and Fold the details to close them.
If you pick a place that receives its own stock in Tansi, a notice explains that a delivery withdrawal leaves the warehouse and isn't added anywhere. Select Make it a transfer instead: Tansi creates a draft transfer with the same items and notes and tells you to check and submit it. If you cannot raise transfers it says so.
Adding items
Pick the warehouse first (Pick the warehouse first to see what it has.). Then use the add-items bar: search, a handheld or camera scan, Browse catalogue to pick many at once (stock shown is the warehouse and everything stored inside it), a batch scan, or a blank line. Each option shows N available or Not in stock here.
| Column | What it is |
|---|---|
| Item | With a note icon for a Note for the picker or the department. |
| Available | What the warehouse holds. |
| Requested | What the email asked for. |
| Send | What you will actually send; 0 if none. |
| Lot | Auto (soonest expiry) or a specific lot. |
| Pick from | Where each quantity will be picked, once saved (Shown after saving.). |
Group by category and Only lines that need a look tidy the table. Check stock again refreshes the pick plan. Chips above the table count to send, short of the request, not enough in stock and incomplete.
- Only 6 in the warehouse. — select Send the 6 there to lower Send to what is in stock. When the warehouse has none at all the line says None in the warehouse. and the button reads Send none.
- 4 short of the request: the department orders the rest. — fine to ship.
- Send what's there on all N in the footer (on that line when only one is short) fixes every shortage at once.
Saving, printing and shipping
| Button | What it does |
|---|---|
| Save draft | Saves it and gives it a number. No stock was taken. Your workspace may also save drafts automatically. |
| Print pick list | Opens the print preview of the pick list (saving first). After shipping it becomes Print withdrawal report, showing the lots, expiry and places actually taken, with a received-by block for a signature. |
| Record shipment | Takes the stock off the warehouse — all of it or none. Optional Carrier, Tracking number and Packages go on the report. |
| Cancel withdrawal | Keeps it as canceled. No stock has been taken. |
While something is missing, the footer says what: Pick the warehouse it is sent from., Pick the department it goes to., Add at least one item., 2 lines are incomplete., 1 line asks for more than the warehouse has. or Nothing is set to be sent.
Record shipment confirms first: This can't be undone here; a mistake is corrected with a stock adjustment. If stock ran short since you saved, Tansi keeps it as a draft and asks you to lower Send on the marked lines.
Withdraw for Delivery: delivery, discrepancies and closing
After shipping, the panel shows the Shipment (from, when and by whom, the ledger reference, carrier, tracking number and packages), the Request and destination, and the Items sent: Requested, Sent, Short, Lot asked for and Taken from. Change carrier or tracking corrects the courier details.
Recording the delivery
- When the department confirms it arrived, open the withdrawal.
- Under Delivery confirmation, enter Delivered on (not in the future) and How it was confirmed — both required — and, if known, Confirmed by (name) and Notes.
- Select Record delivery in the footer. The status becomes Delivered.
Attach the email, signed report or courier proof under Documents. A recorded confirmation can be corrected with Change confirmation and Save the confirmation.
Discrepancies
Under Discrepancy shortages, damage, wrong items:
- What went wrong (leave blank if nothing).
- How it was resolved — Needed before closing one with a discrepancy. Stock sent again or taken back is recorded as its own withdrawal or receipt.
- Save discrepancy. Clearing the first box clears the discrepancy.
Documents
Once the withdrawal has been saved, the Documents card (kept for audit) takes files: choose What it is, then Attach a file. Accepted: PDF, PNG, JPG, Word, Excel, Outlook messages (.msg, .eml) and text, up to your workspace's file-size limit. Remove a file with its delete icon.
Closing
Review and close reminds you to check the confirmation and documents are there (and the discrepancy resolved). Close withdrawal asks Close this withdrawal? — It can't be changed after this. Its documents stay with it.
What can still change at each stage
| Stage | You can still change |
|---|---|
| Draft | Everything: details, items, quantities, lots. Or cancel it. |
| Shipped | Carrier, tracking number and package count; documents. The items sent are fixed: a mistake is corrected with a stock adjustment, or by sending the rest on a new withdrawal. |
| Delivered | The delivery confirmation, the discrepancy and its resolution, and documents. |
| Closed or Cancelled | Nothing. Both stay in the list for the record. |
Use Back to the list to leave without changing anything. If you close the panel with unsaved changes on a draft, Tansi asks Discard your changes? first — nothing is recorded and no stock has been taken.
Inbound deliveries and receiving against a request
Expected Inbound Deliveries lists approved purchases and transfers awaiting receipt. It opens from Receive Deliveries in the always-shown part of the menu and from Warehouse › Inbound Deliveries; both are the same page.
The page needs the right to receive purchases or to receive transfers. A site that may only receive transfers sees transfers only; purchase orders are left off its list.
Figures and filters
- Pending receipts (approved and awaiting), Items inbound (outstanding units), Overdue (past the need-by date).
- Search or scan: request number, your workspace's External PO number, tracking number, supplier or item.
- Destination: one or more places; a region includes everything in it.
- Priority (Any, Low, Normal, High, Urgent), Need-by from and Need-by to.
A handheld scanner ends with Enter. If the packing slip's barcode matches exactly one expected delivery, Tansi opens that request straight away, ready to receive.
Columns
| Column | Shows |
|---|---|
| Request # | A link to the request, with a purchase or transfer icon. |
| Type | Purchase or Transfer. |
| Need By | The date and 3d overdue, Today or in 5d. |
| Source, Destination | Supplier or sending site; where it is going. |
| Tracking # | The first number and +N more. |
| External PO | Your workspace's label for the finance system's PO number. |
| Items, Outstanding Qty | Lines and units still to come. |
| Status | Overdue, Approved or In Progress (partly received). |
Select a row to open its details in place: every tracking number with carrier and whether it was received; for purchases the External PO (Not assigned yet), Supplier invoice and Expected delivery; the priority; and each line's Ordered, Received and Outstanding. A delivery received in full drops off the list.
Receive against request
On Stock Levels, Receive against request opens a small dialog for when the boxes are in front of you:
- Type in Search by number. Only open requests are offered (not completed, canceled or rejected), shown as number · type · stage, up to 20.
- Or scan the request's docket into Or scan request docket and press Enter. A scan that does not match an open request clears the box so you can try again.
- Picking one opens the request with its receiving panel ready.
Receiving itself — lots, quantities, short deliveries — is covered in Receiving against a request.
Exceptional receipts: the queue
Sometimes boxes arrive that no Tansi purchase order or transfer explains: a purchase-card buy, an emergency order, a donation. Exceptional receipts (from the button on Stock Levels) is the queue of these deliveries received outside a Tansi purchase or transfer workflow, and the place to close each one with an audit trail.
The finance system's purchase order number has a name your workspace chooses, for example PeopleSoft PO. This manual says External PO.
Held, or straight on hand?
What happens to the stock depends on a switch in Request Settings › Purchasing, and the banner at the top tells you which applies:
| Setting | Stock without an External PO | To close the exception |
|---|---|---|
| Off | Held: on the shelf but reserved and unavailable. | Add the External PO; every line of the delivery is released. |
| On | On hand and usable straight away. | Add the External PO; the exception closes. Anything received before the switch was turned on is still held. |
The page
- Figures: Pending deliveries, Held item lines, External PO already recorded.
- Drafts: receipts started but not recorded — Nothing has been received for these yet. Continue or Delete each.
- Filters: Search or scan (receipt, supplier, packing slip, External PO, location, item), Status (Pending, Resolved, All), Supplier, Department, Location, Received from, Received to, Clear filters.
| Column | Shows |
|---|---|
| Receipt | Its reference, how many lines, stock held or stock on hand, and For a department. |
| Received | Date and time. |
| Supplier / delivery | Who sent it and the delivery reference. |
| Items, Location | |
| External PO | An amber External PO required chip, or the number. |
| Status | Pending (with N of M lines still open) or Resolved with when and by whom. |
| Paperwork | Attached files, and Attach for editors — the invoice often arrives after the boxes. |
Closing an exception
- Select the green button on the row: Add External PO & release, Add External PO & close, Verify & release or Verify & close, depending on whether a number is already there and whether the stock is held.
- In Resolve exceptional receipt, check the Pending delivery and its facts.
- Enter or check the External PO or reference number — the purchase order, card receipt or other approved reference that pays for this delivery. Required, up to 100 characters.
- Select Release & close (or Close when the stock is already on hand). Tansi says Released and closed ... (N line(s)).
The page needs the right to receive purchases; adding receipts and closing them needs edit rights on it. Receiving a box is not the same as being able to release it, so a held receipt may be waiting on someone else. Every exception is listed, with who received it, on the Warehouse Receipts Without PO report.
Exceptional receipts: recording a delivery
Select Add receipt on the queue. The page New exceptional receipt warns: Use this form only when a delivery cannot be matched to a Tansi purchase order or transfer. A chip in the corner says what will happen: External PO supplied — release on save, No External PO — stock goes on hand or No External PO — stock will be held.
1 · Delivery details
| Field | Notes |
|---|---|
| Receiving location | Required. Each item then picks its own spot inside it, so one delivery can split across a fridge, a shelf and a cage. |
| Supplier or source | Required. Who sent it. |
| Packing slip / delivery reference | Required. A packing slip, card receipt, tracking number — or None. |
| External PO or reference number (optional now) | Leave blank if it has not been issued. If you enter it now, the receipt is released and closed when saved. |
| Exception category | Required: Purchase card / direct purchase, Emergency purchase, Donation / sample / no-charge delivery, Authorized non-PO replenishment or Other approved exception. |
| Department | Who the delivery is for. Filled in from the items when they all belong to one. |
| Business justification / exception context | Required, up to 1,000 characters. |
2 · Items
Add item opens Add receipt item; Browse items adds many; New item (for Item Master editors) saves a draft, opens the item form and brings the new item back as a line.
| Line field | Notes |
|---|---|
| Item | |
| Quantity | Quantity, or for container items Vials received (the container word) with the Stock quantity in doses worked out for you. |
| Unit cost | Feeds the Estimated value. |
| Put away into | Where it lands; Tansi steers toward the spot already holding the item. A line still showing Choose spot blocks recording. |
| Storage area (optional) | A named shelf, bin, cabinet or room. |
| Lot and tracking details | Lot number and expiry date (required when the item requires them), serial number, manufactured date, manufacturer, and the item's own tracking fields. |
| Funding source | Optional. |
3 · Paperwork
Choose What it is and Attach a file — the packing slip, invoice or card receipt; a photo from a phone works too. Attaching a file saves the receipt as a draft first, so the file has somewhere to stay.
4 · Review and record
- Read the summary of what will happen to the stock.
- Tick I confirm this delivery may be recorded under the approved exceptional receiving procedure.
- Select the main button: Receive, release & close (number supplied), Record receipt (goes on hand) or Record receipt on hold.
Save as draft needs nothing filled in and moves no stock: it waits under Drafts on Exceptional receipts. Your workspace may also save the draft automatically.
If you change the receiving location after adding lines, Tansi asks you to re-check the storage spot on the affected lines.
Returns on hold
Stock › Returns on hold lists stock that stations sent back, held until someone restocks it, disposes of it or sends it back to the vendor. Returns are held only when your workspace turns that on in Request Settings › Purchasing; otherwise they go straight back into stock and the page says so (anything held earlier is still listed).
The list
Filter by Place, Search (item, lot, return number or station) and Show resolved. Columns: Item (with a credit-return chip where the item can be returned for credit), SKU, Lot / expiry, On hold (6 of 10 after partial decisions), From, Return (link to the return request), Reason (the station's own words), Received and Held at. Expand a row to see decisions so far: Restocked 4, Disposed of 2 (Expired), Sent 3 back to the vendor, with who and when.
Deciding
Each decision can take part of the hold; the quantity starts at everything still on hold (Leave the rest for another decision.).
| Button | What happens | You enter |
|---|---|---|
| Restock | It becomes usable stock at that place again: it can be picked, sent and withdrawn. | Quantity, optional Note. |
| Dispose | It comes off stock and is recorded on the waste report. | Waste reason (required), Quantity, optional Note. |
| Return to vendor | Starts a vendor return against a purchase order that delivered it. The stock stays held until it is shipped back. | The Purchase order (a Same lot badge marks the best match), What the vendor does, Reason, Vendor RA # (optional), Quantity, and a required Comment. |
For a vendor return, Replacement means they send new stock: the PO line is open to receive again; Credit means they credit us: enter their credit note on the PO when it comes. Reasons are Wrong item, Damaged, Failed quality check, Expired and Other. Tansi shows the new return number with a link to the purchase order: Mark it shipped, and enter the credit note or receive the replacement, on the purchase order.
If no purchase order ever received the item: No purchase order has received this item, so it can't go back to a vendor from here. Restock it or dispose of it instead.
Deciding takes the same right as receiving the transfer at the place it is held. Return to vendor also needs edit rights on receiving purchases. The page itself has its own permission; without it you see You don't have permission to see returns on hold.
Waste Management
Stock › Waste Management: Review discarded, damaged, expired, spoiled, and returned inventory recorded in the stock ledger. It brings together waste recorded here, on Withdraw Supplies, by the expiry clock, by counts (Damaged and Expired shortfalls) and by disposing of held returns.
Recording waste
Record waste is a split button. The main part, and Several items at one location in its menu, open the waste panel. Single item (dialog) opens the smaller Record Waste dialog.
Everyone who may record waste gets both ways in: stock-tracking editors, and site staff through their withdraw permission. Each line can only come from a location the person is allowed to write to.
The waste panel, Several items at one location. Each line posts its own waste entry to the ledger.:
- Under Where and who, choose the Location. On a shared account, fill in Recorded for (required there, optional otherwise).
- Under Applies to every line, choose a Waste reason and add Notes (optional) (up to 500 characters, for example fridge failure overnight 12 Sep).
- Add lines: scan or type a SKU in Scan or type a SKU and press Enter (adds 1, or 1 more), or select Add line and pick the Item.
- For each line, set Quantity (no more than is on hand), the Lot or Lot / area when there is more than one, and, if it differs, its own Reason and Note (up to 200 characters).
- Check the footer — 3 lines · total qty 14 — and select Record waste.
Tansi confirms Recorded waste on 3 lines · total qty 14. Lines with problems say what is missing: Pick an item., Pick the lot being wasted., Enter a quantity greater than zero., Pick a reason, or set the waste reason above.
Each line posts separately. If one fails part-way, the earlier lines stay recorded and the message says Waste not fully recorded. Check the disposal audit before trying again, so nothing is recorded twice. Changing the location clears the lines (Tansi asks first).
The single-item dialog asks for Item, Location, Storage Area (optional), Quantity wasted, the lots when the item is lot-tracked, the Waste reason, Details (optional) and, on a shared account, Recorded for. It confirms Recorded N ... as waste for ....
Unlike the dispensing waste dialog, these lists include Expired after opening. Keep it for units that expired after opening; use Expired when the product's own date passed.
Reviewing waste
| Filter | Notes |
|---|---|
| From, To | Default: the first of this month to today. |
| Product | One product, or all. |
| Location | Only places you can see; empty means all of them (All my locations). |
| Apply filters | Reloads with the dates, product and location. |
| Search results | Item, SKU, lot, reference or person, within what is loaded. |
| Waste reason | One of the reasons present. |
| Reset | Back to this month. |
The figures show Waste events, Products affected, Locations and Quantity wasted (one chip per unit of measure, so doses and boxes are not added together).
The Disposal audit table lists Date, Product, Lot / expiry, Location (full path), Reason (with the detail typed), Quantity, Reference and Recorded by. Use the export menu for a spreadsheet, or Download PDF for the waste report over the chosen dates.
Reorder Suggestions: reading the list
Stock › Reorder Suggestions lists items at or below their reorder threshold, one row per item per location. A warehouse with plenty does not hide a remote site that has run dry: that site gets its own row.
How the list is worked out
- The levels for each item at each place are that place's own, else the site above it, else the item's own levels at its main location.
- A row appears when what is available there is below the reorder point.
- Where a location sets a lead time, the reorder point rises to cover average daily use through the lead time plus any safety-stock days.
- Suggested Qty brings the place up to its maximum (maximum minus on hand) when one is set, otherwise up to the reorder point.
- Inactive items and closed locations are never suggested. The worst rows come first.
Despite the wording at or below, a row appears only once available drops below the reorder point.
Figures and filters
Items below reorder and Items below min, plus Suggested order value for people allowed to see costs. Filters: Search, Category, Location, Urgency (Below reorder, Below min), Supplier (including No supplier), Days left <=, and Usage window (7 to 365 days — the period average daily use is worked out over). Clear resets them.
Columns
| Column | What it tells you |
|---|---|
| Item Name | With SKU and category. |
| Location | With the path above it, so a storage room says which site it is in. |
| On Hand, Available | Available is red below the minimum, amber below reorder, with Reorder | Min | Max underneath. |
| Reorder, Min, Max | The levels used. |
| Suggested Qty | With a cart icon to start a purchase request for that row (or a supply request icon if you may raise only those), and the preferred supplier. |
| Days Left | How long stock lasts at recent use: red under 7, amber under 14, N/A without usage. |
| Avg/Day | Average daily use, and how much was used in the window. |
| Preferred Supplier |
Most column headings sort the list, and several have a filter icon for contains or >= / <= filters. Rows below the minimum are tinted red, below reorder amber. Some columns hide on narrow screens. The footer shows Showing and Selected.
With nothing short: All items are at or above reorder thresholds — No replenishment is suggested at this time.
An item can be below its reorder level and still have months of stock, if it barely moves. Another can be above it and run out next week. Sort by Days Left when you are deciding what to deal with first.
Reorder Suggestions: turning them into orders
Tick the rows you want. The header buttons count your selection.
| Button | What it creates | Who sees it |
|---|---|---|
| Create Supply Request (N) | One supply request per site, with the suggested quantities, for the hub to source and ship. One request opens in the editor; several are created as drafts: Find them under My Requests. | People who may raise supply requests |
| Create Purchase Draft (N) | Purchase drafts grouped by supplier (below). | People who may raise purchase requests |
| Create Site Feedback Survey (N) | A draft feedback survey listing the recommendations, so sites confirm quantities before anything is bought. Add location admins as recipients, then activate it. | Everyone on the page |
| Save Snapshot | Keeps a record of the list as it stands: Snapshot saved — N recommendations captured. | Everyone on the page |
| Refresh | Reads the list again. | Everyone |
One supplier per purchase order
A purchase order is always for a single supplier, so Tansi groups your rows by preferred supplier. Labels follow your workspace's names, so Purchase Order may read Purchase Request.
If the rows share one supplier
- Select Create Purchase Draft (or the cart icon on one row).
- If other suggestions come from the same supplier, Additional reorder items available lists them with their suggested quantities. Tick the ones to bring along, or Select all.
- Choose Add selected (N), Continue (without extras) or Cancel.
- Tansi creates the draft, with the Ship To set to the facility around the short shelf. If it finds stock elsewhere that could be transferred instead, Alternatives available offers to create those transfers too; otherwise the draft opens for you to check and submit.
If the rows span several suppliers
- Select Create Purchase Draft.
- Multiple suppliers — split into separate Purchase Orders explains: Because each Purchase Order is for a single supplier, we'll create N separate draft Purchase Orders — one per supplier. Each supplier is listed with its items.
- Rows whose supplier has no vendor record say (no vendor on file — pick one on the draft); rows with no supplier at all are grouped under No preferred supplier.
- Select Create N drafts. Tansi says how many it created and opens your Requests list.
- Open each draft to set quantities, adjust the vendor if needed, and submit for approval.
Quantities for the same item at several short locations are added together onto one line. Prices come from that vendor's supplier record, else the preferred supplier, else the item's own price.
If no price is found, the draft's line has no price and its approval is routed as a $0 order. Check prices on each draft before submitting.
Some wording on these screens comes from health-care customers (vials, doses, controlled items). The features work the same for any stock: tools, parts, office supplies, event kit or building materials.
Snapshot History
Surveys › Snapshot History opens Reorder Snapshot History: the 50 most recent snapshots of the reorder list. Snapshots are created automatically each night and whenever someone selects Save Snapshot on Reorder Suggestions. The page only shows snapshots: there is no way to edit or delete one here, so each stays a record of what the list said at that moment, even after stock, levels or suppliers have changed.
| Column | Shows |
|---|---|
| Date | When it was taken. Select it, or the row, to open it. |
| Source | Automated (nightly) or Manual. |
| Items Evaluated | How many item and location rows were checked. |
| Recommendations | How many were short. |
| Filters | Filtered when the snapshot was saved with filters on, so it does not cover everything. |
Inside a snapshot you see its date, counts and source, then each line: Item, Location, On Hand, Available, Reorder Point, Suggested Qty, Days Left (red under 7, amber under 14) and a Reason code such as HIGH_USAGE. Back to list returns. Both views have an export menu.
With none yet: No snapshots yet. Snapshots are created automatically each night or when you click Save Snapshot on the Reorder Suggestions page.
A snapshot answers what did the system tell us to order on the 3rd? — useful when reviewing a stock-out, or comparing what was suggested with what was actually ordered.
Reviewing a stock-out with snapshots
- Open Snapshot History and find the nightly snapshot from the week before the stock-out (Automated).
- Open it and look for the item at that location. If it is there, the system did suggest it: check whether an order followed.
- If it is not there, the item was above its reorder point that night. Check its levels on Reorder Suggestions or Critical Items — the reorder point may be too low for how fast it is used.
- Export the snapshot lines if you need to share them.
Order Schedule
Where Reorder Suggestions is driven by stock levels, Stock › Order Schedule is driven by the calendar: facilities due to order and their upcoming ordering cadence.
Due list
| Column | Shows |
|---|---|
| Facility | A link to Location Management. |
| Next due | The date, with Due (red) when it is due or overdue, or Due soon (amber) inside the lead window before it. |
| Days | Days until it is due. |
| Cadence | How often: the frequency and the interval, shown as frequency × interval. |
| Template | The request template the order starts from. |
| On hand | N items / N units at the facility. |
Start order creates a draft from the schedule's template, dated for the due day, and opens it. A schedule without a template opens a new, empty request of its type. The list can be exported; Refresh reloads it. With no schedules: No facilities have an ordering schedule yet.
Calendar
The Calendar tab shows a month with an Ordering due entry per facility on each due day, marked overdue, at risk (inside the lead window) or due. Missed due days from the last 60 days are carried forward. Selecting an entry opens Location Management.
An ordering cadence belongs to a facility, not to an item: how often, the lead days, the template and any blackout days are set on the location in Location Management. The template decides which items are on the order.
Example: a weekly order from a remote site
- An administrator gives the remote site a weekly schedule with a two-day lead window and the template Weekly site order.
- Two days before each due day the site shows Due soon; on the day it shows Due.
- The site coordinator selects Start order. A draft opens with the template's items, dated for the due day.
- She checks quantities against what is on hand, adjusts them, and submits. If she misses the day, the calendar keeps showing it as overdue.
Use the schedule for the routine order and Reorder Suggestions for anything that runs short between orders.
Use cases: day-to-day stock control
These walk-throughs mix a construction yard, an office, an events store, a warehouse and a clinic. The screens are the same everywhere.
1 · Restocking a service cart (construction yard)
- A yard hand opens Move Stock from the menu and picks the yard as From location.
- She scans a box of anchor bolts and a roll of tape; each scan adds a line.
- For each line, Coming from is already chosen (they sit on one rack) and under Going to she picks Van 3.
- She types Monday restock in Reason / notes and selects Move stock. The van's stock goes up at once; nobody has to approve it.
2 · Monthly count of the stationery cupboard (office)
- The office manager opens Inventory Count and picks the cupboard in Count locations. Its rows load.
- She types what she finds in Counted. Printer paper: expected 20, counted 18. Pens: expected 5 boxes, counted 7.
- She sets paper to Unrecorded issue / usage and pens to Found.
- Toner was not checked, so she leaves it blank — it will not be touched.
- Apply Adjustments (2), then Apply. Both corrections appear in the Stock Ledger with the reason and the expected and counted figures.
3 · A storm damages stock (events store)
- Rain gets into a tent store and ruins four kinds of signage and two boxes of programs.
- The store lead opens Waste Management › Record waste, picks the tent store, sets Waste reason to Damaged and notes storm, 14 Jun.
- She scans each item; lines fill in. One sign is held in two lots, so she picks the lot on that line.
- Record waste. The Disposal audit lists every line with her name, and the PDF goes to the insurer.
4 · A quantity that was wrong (warehouse)
- A picker reports the system shows 50 hard hats but the shelf has 48, and nobody can find any loss.
- A supervisor opens Stock Levels, selects Adjust, scans the hard hats, picks the warehouse, enters -2, and writes miscounted at receipt, checked with packing slip.
- Apply Adjustment. Had the two been broken, waste would have been the right record.
5 · Finding the right lot during a count (clinic)
- During a count a nurse finds a lot of dressings with water damage.
- From the line's menu she selects Mark quarantined and gives the reason.
- The message offers Create return to the warehouse the clinic orders from; she selects it and a return transfer opens with the line filled in.
- Back on Stock Levels the lot shows Quarantined and counts as zero available, so nobody withdraws it meanwhile.
6 · Who took the last one? (any site)
- A manager sees an item out of stock on Critical Items.
- From the row menu, Stock by location shows where it was; then the Stock Ledger, filtered to the item and site, shows each withdrawal with who recorded it and who it was for.
- The last removal looks wrong, so she uses Report an incident linked to this stock removal on that row.
Use cases: receiving, shipping and reordering
1 · A purchase-card buy arrives before the paperwork (office)
- Toner bought on a purchase card arrives. The receptionist opens Stock Levels › Exceptional receipts › Add receipt.
- Receiving location: the office. Supplier: the store. Delivery reference: the card receipt number. External PO: blank. Exception category: Purchase card / direct purchase. Justification: printer down, urgent.
- She adds the toner line, puts it away into the supply cupboard, photographs the card receipt under Paperwork, ticks the confirmation and selects Record receipt on hold.
- A week later finance issues the PO number. A colleague with receiving rights selects Add External PO & release on the queue, enters it, and the toner becomes available.
2 · Shipping to a department without Tansi (central warehouse)
- The Housing department emails asking for 30 smoke alarms and 10 fire blankets.
- Warehouse staff open Withdraw for Delivery › New withdrawal, pick the warehouse, type the request details and choose A department: Housing.
- They add both items. Only 24 alarms are in stock, so they select Send the 24 there; the line now reads 6 short of the request: the department orders the rest.
- Save draft, then Print pick list. The picker works from the printout.
- When the van leaves they add the carrier and tracking number and select Record shipment. The stock comes off the warehouse.
- Housing replies that one blanket was torn. Staff record the delivery date and how it was confirmed, enter the discrepancy and how it was resolved (a replacement sent on its own withdrawal), attach the email, and select Close withdrawal.
3 · Returned stock from a station (health warehouse)
This example is clinical; the same steps apply to tools coming back from a job site.
- A community station returns 10 boxes of gloves. The warehouse receives the return and, because the workspace holds returns, it appears on Returns on hold.
- Six boxes are sealed: Restock, quantity 6.
- Two are torn: Dispose, quantity 2, reason Damaged.
- Two are the wrong size and came on a recent purchase order: Return to vendor, pick that order (marked Same lot), choose Replacement, reason Wrong item, and a comment. Tansi starts the vendor return and the stock stays held until it ships.
4 · Weekly reorder across suppliers (multi-site retailer)
- On Monday the buyer opens Reorder Suggestions, sets Usage window to 30 days and sorts by Days Left.
- She ticks everything under 14 days — 18 rows from four suppliers.
- Save Snapshot, so there is a record of what was suggested.
- Create Purchase Draft (18). Tansi offers four drafts, one per supplier; one group has no vendor on file, so she will pick one on that draft.
- Create 4 drafts. In the Requests list she checks prices and quantities on each and submits them.
5 · A site orders on its calendar (remote facility)
- Order Schedule shows a remote facility Due soon for Thursday.
- The coordinator selects Start order; a draft opens from the facility's template, dated Thursday.
- She adjusts quantities against Reorder Suggestions for that location and submits.
Scan & Receive: looking items up
Warehouse › Scan & Receive is the fastest way to look something up. Scan a barcode to look it up. Known items show full details, stock on hand and quick actions; unknown barcodes can pull product data from Go-UPC so you can add them in seconds. Request barcodes and QR codes (PO, TR, SR, RTN) open the request alongside. The page needs the scan permission; each action button has its own permission.
Scanning
| Way | How it works |
|---|---|
| Typing | Type in Scan or enter a barcode and press Enter or the search icon. |
| Handheld scanner switch | Turn it on when you use a USB or Bluetooth scanner. The field reads Ready to scan, keeps focus, clears after each scan and beeps. A green line shows Listening — N scans this session. |
| Use camera | Scans with the device camera. Only shown if camera scanning is turned on for your Tansi site. Stop camera turns it off. If the browser blocks the camera: Could not start camera. Check permissions. |
Tansi recognizes a barcode by its product number in any of the usual formats, by the item's own barcode, or by its SKU. When the barcode is a GS1 label, Tansi also reads the lot number, expiry date and serial number.
Warnings before the item opens
If the item is restricted, high risk, or has receiving requirements, an Inventory warning appears first, for example This item has receiving tracking requirements. Receiving requires: lot number, expiry date. If the scanned lot is quarantined, suspended or recalled, a Lot status warning follows. Press Acknowledge to see the item, or Cancel to drop the scan. Acknowledgements are recorded.
What a found item shows
- A green banner, In inventory, or amber In inventory — item is inactive with Stock movements may be restricted.
- Photos, category, name, and chips for the SKU, barcode and any lot, expiry and serial number read from the label.
- Default location, Unit of measure, Storage type, Thresholds (min, max, reorder), Project and notes. Pricing appears only if your role may see costs.
- An On hand strip: total units, how many locations, active lots, and days to the nearest expiry (amber within 30 days, red when past).
- A table by Location and Storage area with On hand and Reserved, and a Lots table (up to 12) with expiry and status.
Quick actions
| Button | What it does | Needs |
|---|---|---|
| Receive stock | Opens a receipt without a purchase order, with this item filled in. | Receiving permission |
| Adjust stock | Opens the Adjust Stock dialog. | Edit on stock tracking |
| Transfer | Starts a stock transfer request for this item. | Permission to create transfers |
| Create Purchase Order | Starts a purchase order for this item (your workspace's name for it). | Permission to create purchases |
| View item | Opens the item page. | — |
| Edit item | Opens the item's edit page. | Edit on Item Master |
| Print label | Prints a barcode label with the item name, SKU and default location. | — |
With Item Master edit access, Assign default location and Set change the item's default location (Location set to: …).
Adjust stock opens the adjust dialog without the scanned item chosen; pick the item again inside it. Print label prints the code exactly as scanned, so a long GS1 label prints as a long barcode. To print the item's own short barcode, use the label printing on the item page.
Receiving without a purchase order
The button at the top, Receive without a Purchase Order (named after your workspace's purchase term), opens an exceptional receipt for a delivery with no Tansi order behind it. Those receipts are controlled and reported separately; see Exceptional receipts.
Recent scans
The left column keeps this session's scans: a green dot for found, red for Not recognised, the item or request, the GTIN, lot and expiry when the label carried them, and the time. Click a row to scan it again. The last 8 are shown and 50 are kept; export downloads the full list. Clear empties it. The list is lost when you leave the page.
Two ways to add inventory
There is more than one route to the same result, and which you use is mostly a matter of what you have in front of you. Both recordings have sound.
Option 1 — the long way round, through the item and lot screens. Use it when the item is new to Tansi, or when you need to set the lot details yourself.
Option 2 — the quicker route, when the item already exists and you only need the stock booked in.
Scan & Receive: unknown barcodes and request codes
When the barcode is not in your inventory
Tansi shows Not in your inventory and No item matches …, with the GTIN, lot and expiry if the label carried them. Three buttons follow:
| Button | What it does | Needs |
|---|---|---|
| Look up product data | Searches Go-UPC, an outside product database (Looking up product data in Go-UPC…). | Edit on Item Master |
| Create item manually | Opens a blank new item, and brings you back here afterward. | Edit on Item Master |
| Re-scan | Puts the cursor back in the scan field. | — |
If Go-UPC knows the product, a card shows the brand, name, code type and code, a Category hint and the description. Add to inventory… opens the full new item page with those details filled in, then returns to Scan & Receive when you save. Dismiss closes the card. If Go-UPC does not know it either: This barcode wasn't found in Go-UPC either — create the item manually.
Each lookup is a paid call to an outside service, which is why it waits for you to press the button. Check the scan was clean first.
Scanning a request
Tansi prints barcodes and QR codes on its own request documents (purchase orders, transfers, supply requests and returns). If you can view requests, scanning one opens a drawer on the right, and the page shows Request … with Show request and Open request. The scanner keeps listening: the next scan replaces what is shown.
The drawer is read-only. It shows:
- Scanned request, the number, the type (Purchase, Transfer, Supply or Return), its stage and how far filling has got.
- Requested by, Requested on behalf of, the route (supplier and Deliver to; or From and To or Return to, with Shipped and Tracking; or For location), Need by and Submitted.
- Lines: each item with Requested, Shipped (transfers and returns) and Received. Canceled lines are struck through.
| Button in the drawer | Shown when |
|---|---|
| Receive | You may receive this kind of request, a line is still outstanding, and something has been sent or shipped. |
| Warehouse work order | It is an approved or active transfer and you work the warehouse queue. |
| Open request | Always. |
Use cases
- Dock receiving (warehouse). A pallet arrives with a packing slip. Scan the slip's QR code; the drawer shows the transfer and what was shipped. Press Receive and complete the receipt on the request page.
- New product on a job site (construction). A foreman scans a new brand of anchor bolts. Not in inventory: press Look up product data, check the card, press Add to inventory…, choose the category and save.
- Quick stock check (office). Someone asks if there is more printer paper. Scan the ream; the On hand table shows 12 boxes in the supply closet and 40 at head office.
Carriers
Carriers are the couriers and freight companies that move your stock. The carrier list feeds the carrier pickers on transfers and shipments. Open it from Admin › Carriers. The page is called Carrier Management: Manage shipping carriers, accounts, and service levels. Anyone with access to the page can read it; adding, deactivating and copying carriers need edit access.
Your own carriers or Tansi's common list
Tansi ships with a common starter list of carriers. Shipping screens offer only Active carriers. A workspace with no active carriers of its own is offered the common list, so shipping is never empty. A blue banner explains which case you are in:
- Shipping screens are offering the N common carriers: your workspace has none of its own. The common carriers are not listed on this page and cannot be edited or given finance codes until they are copied in.
- Shipping screens offer only the carriers below: you have your own, and the banner names the common carriers you do not have.
Copy the common carriers here copies them into your workspace. Carriers you already have under the same name keep their details; only empty fields are filled. Transfers and shipments that used the common carriers move to your copies. It is safe to run again (Nothing to copy: this workspace already has them.).
Tiles, search and list
Four tiles count Active, Preferred, Insurance Expiring (insurance expiring within 30 days or already expired) and Types. Below, Search looks at name, code, account and contact, Status filters by status, and Refresh reloads.
| Column | What it shows |
|---|---|
| Name | With a star for preferred carriers, and the city. |
| Code, Type | Short name and carrier type. |
| Contact | Main contact and phone. |
| Account # | Your account number with the carrier. |
| Services | The first three service levels, then +N more. |
| Status | Active, Suspended, Pending Approval, Expired Insurance, Blacklisted or Inactive (your workspace's status list). |
| Actions | View / Edit, and Deactivate for carriers that are not already inactive. |
Deactivating asks Are you sure you want to deactivate …? and confirms Carrier deactivated. The export menu downloads the list with your filters noted.
Adding or editing a carrier
Add Carrier opens a dialog with five tabs. Only Carrier Name is required, and a new carrier starts as Active.
| Tab | Fields |
|---|---|
| Basic Info | Carrier Name, Code / Short Name, Carrier Type, Status; contact (Main Contact Name, Phone, Dispatch Email, Customer Service Email, Claims Email, After-Hours Phone, Website); address (Address, City, Province / State, Postal / ZIP, two-letter Country). |
| Account & Billing | Carrier Account Number, Customer Number, Billing Account Number, Contract Number, Currency, Fuel Surcharge %, Discount %, Minimum Charge, Payment Terms, Credit Limit, Tax Rules, and Freight account: The finance account this carrier's freight bills are coded to. |
| Shipping | Service Levels (comma-separated, such as Ground, Express, Overnight), Default Shipping Method, Pickup Lead Time, Delivery Areas / Regions Served; switches Pickup Required, Dangerous Goods, Temperature Controlled, Liftgate Available; Max Weight Allowed, Max Dimensions. |
| Tracking | Tracking URL (use {tracking_number} where the number goes); switches API Enabled, Label Printing, Rate Quote Supported, Shipment Status Sync. |
| Operations | Preferred Carrier ⭐, Use for Purchase Orders, Use for Internal Transfers, Use for Customer Deliveries; Claims Contact, Damage Claim Time Limit, Claims Process Notes, Missing Shipment Process; Insurance Expiry Date, Compliance Notes (WCB, safety documents, agreements, rate sheets), General Notes. |
Press Create or Update. The Freight account appears only for carriers that belong to your workspace, which is one more reason to copy the common carriers in.
With a tracking URL such as https://example-courier.com/track?n={tracking_number}, a shipment's tracking number can be turned into a link without anyone retyping it.
Use case: setting up a regional courier (construction)
- A contractor ships tools between its yard and job sites with a regional courier. Open Carriers and press Add Carrier.
- Enter the name, code RCX, type and the dispatch email.
- On Account & Billing, enter the account number, payment terms Net 30 and the Freight account.
- On Shipping, list Same day, Next day as service levels and switch on Liftgate Available.
- On Operations, switch on Preferred Carrier ⭐ and Use for Internal Transfers, enter the insurance expiry, and press Create.
- Thirty days before the insurance runs out, the carrier is counted on the Insurance Expiring tile.
The Lots board
A lot is a batch of an item made or received together, identified by its lot number. If what you hold expires or could ever be recalled, the Lots board is the page you live on. Open it from Stock › Lots. It is called Lot & Inventory Tracking: Monitor every lot — expiry, quarantine holds and recalls surfaced automatically. You need view access to stock tracking; the buttons that change lots need edit access.
The board lists only lots held at locations you are allowed to see, and the Where it sits column names only those locations.
The five tiles
The tiles count lots and work as filters: click one to show only those lots.
| Tile | What it counts | What to do |
|---|---|---|
| Total lots | Every lot passing your search and switches, with N need attention. | — |
| Expiring soon | Active lots expiring within the expiry window (30 days unless you change it). | Use them first, or plan to move them where they will be used. |
| Expired | Lots past their expiry date. | Do not use them. Record them as waste, or return them if they carry a Credit return chip. |
| Quarantined | Lots on hold: on hold, do not ship. | Leave them where they are until the hold is decided. |
| Recalled | Lots under an active recall notice. | Act at once: find every location holding them. |
Search, chips and switches
- Search lot #, item, manufacturer, location… also matches the category.
- Status chips: All, Flagged (recalled, quarantined and expired together), Available, Expiring, Expired, Quarantined, Recalled, and Suspended when any lot is suspended. Each shows its count.
- Lot-tracked items only (on by default) hides items that do not need a lot number or expiry, and stock that was never given a lot.
- Has on-hand (on by default) hides lots that are used up.
The tile and chip counts always use the same search and switches as the list, so clicking a count shows exactly that many lots.
Changing the expiry window
While the Expiring view is active, a bar appears: Expiring within a number, and a unit of Days, Weeks, Months or Years, with the cut-off date shown (through 2026-12-15). Months and years follow the calendar: three months from today means the same day three months out. The window also decides which rows are badged Expiring soon.
The table
| Column | What it shows |
|---|---|
| Lot # | The lot number. |
| Item | The item, its manufacturer, and a Credit return chip when the supplier takes it back. |
| Category | Hidden on narrower screens. |
| Expiry | The date and how far away it is: in 12 d, today or 5 d ago. |
| On hand | Everything held, across the locations you can see. |
| Available | On hand minus reserved. |
| Where it sits | A chip per location with its quantity. After six chips, +N more expands the rest. |
| Status | Available, Expiring soon, Expired, Quarantined, Suspended or Recalled. |
| Created | When the lot was first recorded. Hidden on narrower screens. |
Click a column heading to sort; click again to reverse. By default the worst lots come first: recalled, then quarantined, suspended, expired, expiring. Rows are tinted in their status color. Click a row to open the lot's page; the pencil at the end edits the lot without leaving the list.
A hold outranks expiry: a recalled lot that has also expired is shown as Recalled.
A quarantine, suspension or recall does not remove stock from the board's On hand or Available figures: it is still physically there. Elsewhere, Tansi leaves held lots out of its pick and send suggestions and warns anyone who uses one. Read the Status column, not only the numbers.
Exporting and linking
The export menu downloads the rows you see, with the manufacture date, manufacturer and full location list, plus a line describing your filters. Opening the board from an item's lot link shows only that item's lots (Lots — item name), including used-up lots so a recall trace is complete; Clear item filter returns to all lots. Open on lots board on the Nearing Expiry Report opens the board already set to that report's window.
When Tansi suggests a lot to pick or send, it chooses First Expired, First Out: stock without a lot number first, then the soonest expiry. Expired and held lots are never suggested. That is why a pick list may send you to a newer delivery than you expected.
A lot's page: quarantine, suspend, recall
Click a row on the Lots board (or a lot link in an alert) to open the lot's page. The header shows the item, Lot and its number, the expiry date and a large status chip: Active, Quarantined, Suspended or Recalled.
Locations holding this lot
Every location that holds the lot, with Location, Storage area and On hand, then Total on hand. This is the answer to where is the recalled stock? The export menu downloads it, which is useful for sending to each site.
Transaction history
Every movement of the lot: When, Type (with the request number, linked, or the movement's own reference), Qty, From, To, Reason and By. A request number inside the reason is also a link. Export it for a recall report.
Changing a lot's status
With edit access to stock tracking, buttons appear under the status chip:
| Lot is | Buttons | Use it when |
|---|---|---|
| Active | Quarantine | Something needs checking: a temperature excursion, damaged packaging, a supplier query. |
| Suspend | The lot should be taken out of use for a while, for a reason that is not a recall. | |
| Recall | The maker or supplier has issued a recall notice. | |
| Quarantined, Suspended or Recalled | Reactivate | The check is over and the lot can be used again. |
- Press the button. A dialog titled, for example, Quarantine lot shows Lot A2251 → Quarantined.
- Type the Reason. It is required and is shown to people who later meet the lot.
- Press Apply. Tansi confirms with the lot number and new status.
What a hold does
- Held lots are no longer suggested when picking, sending or allocating stock.
- Returns to the warehouse can pick held lots, because sending them back is the point.
- When someone scans or uses a held lot, a Lot status warning appears, for example Lot A2251 is marked quarantined. Acknowledge before continuing., with your reason. They must press Acknowledge or Cancel, and the acknowledgement is recorded in the audit log.
- On the Lots board the stock still counts in On hand and Available, with the hold shown in Status.
The status buttons appear for everyone with edit access to stock tracking. Decide in your own procedures who should quarantine, recall and reactivate lots, and give edit access accordingly.
Correcting a lot's details
Edit lot (also the pencil on the board) opens a drawer for fixing a lot that was recorded wrongly. It never moves stock, and it does not change status.
| Field | Notes |
|---|---|
| Lot number | Required. Must stay unique for the item. |
| Expiry date | Needs the override lot expiry permission; without it the field is locked. When changed, Tansi reminds you: The new expiry decides whether this lot can be sent. Check it against the box. |
| Manufactured, Manufacturer | Optional. |
| Serial number, tracking fields | Shown when the item asks for them or the lot already has a value. |
| Notes | Up to 1,000 characters. |
| Why are you changing it? | Required. Kept in the audit log with what changed. |
Press Save changes. If Tansi refuses (for example, a duplicate lot number), the reason is shown inside the drawer. The (Unspecified) lot cannot be edited; give that stock real lots with Assign lots to untracked stock.
Untracked stock, expiry disagreements and choosing lots
Assign lots to untracked stock
Opening stock is often loaded without lot numbers. Tansi files it on the item's (Unspecified) lot. For items that need lots, the Lots board shows Assign lots to untracked stock in amber with a count. Everything that arrives later gets its lots at receiving; this tool is for what was already on the shelf. You need edit access.
- Press Assign lots to untracked stock. The drawer lists each spot holding untracked stock: item, location path and Untracked quantity (reserved units are shown separately and are not offered). Filter by item, SKU or location.
- Press Assign on a row. The drawer shows Still untracked and Lotted this session.
- Type the Lot number from the box. Existing lots of the item are suggested; a new number creates the lot (press Use … or Enter to accept a new one).
- Enter the Expiry date (required when the item needs one). Picking an existing lot fills in its expiry and locks it.
- Enter the Quantity in this lot, or press All remaining, and an optional note.
- Press Assign to lot. Repeat for the next lot on the same shelf. When everything has a lot, Tansi says so; go back to All untracked stock for the next spot.
If Assign to lot stays gray, hover over it: Enter the lot number first, This item needs an expiry date, Enter a quantity or Only N still untracked. When nothing is left: Every lot-tracked item in your locations has a real lot. Nothing to do.
When a scanned expiry disagrees with the lot on file
A lot number is one batch, so it has one expiry. If you receive, scan or count a lot whose expiry is different from the one Tansi already holds, a dialog appears: Expiry date disagrees with the lot on file. For each lot it shows the date on file and the date scanned or entered, and two choices:
- Keep … (the lot on file) and receive against it. The usual answer when the new label was misread.
- Change the lot to … for all stock in it. Only with the Override Lot Expiry permission. You must say Why the lot on file is wrong (at least five characters), and the old and new dates go into the audit log.
Press Continue once every lot has a choice, or Cancel to go back and check the label.
Choosing lots by hand
Some dialogs (adjusting, issuing and moving stock) show a lot table so you can say which lots to use.
| Part | What it does |
|---|---|
| Lot | The lot number; Unspecified marks stock without one. |
| Expiry | Red when past, orange within 30 days. |
| On hand | What that lot has available here. |
| Qty to use | How much to take. Typing more than the lot holds is cut back, with Only N on hand. |
| Reset to FEFO | Fills the quantities soonest-expiry first (stock without a lot comes first). |
| Total | Shows the total against the quantity needed, in red when they differ. |
If you include an expired lot, Reason for issuing from expired lot appears and must be filled in.
Use cases: lots and recalls
1 · A supplier recalls a lot (health)
This example comes from health care, but the feature is not limited to medical use. It works the same way for building materials, office supplies, event equipment or warehouse parts.
- The supplier emails a recall for lot K4410 of an IV set. Open Stock › Lots and search K4410.
- Click the row. Under Locations holding this lot you see 30 units at the depot and 6 at two clinics.
- Press Recall, type the supplier's notice number as the reason and press Apply.
- Export the locations table and send it to the clinics. Anyone who scans the lot now sees a Lot status warning.
- Raise returns from the clinics to the depot; the return picks offer the recalled lot.
- Export Transaction history as evidence of where the lot went before the recall.
2 · Monthly expiry review (warehouse)
- On the first of the month, open the Lots board and click Expiring soon.
- Set Expiring within to 3 Months. The cut-off date appears beside it.
- Sort by Expiry. For lots expiring soonest, look at Where it sits and move them to the busiest site.
- Click Expired. Record expired lots as waste, or return those with a Credit return chip to the supplier.
- Export the list with your filters noted, and attach it to your monthly report.
3 · A construction supplier's adhesive batch is under question (construction)
- The adhesive maker warns that batch 22-118 may cure badly. Open the lot and press Quarantine with the warning as the reason.
- The lot disappears from FEFO suggestions, so crews requesting adhesive are sent other batches.
- Two weeks later the maker clears the batch. Press Reactivate with Cleared by maker, letter 2026-11-30.
4 · A lot number was typed wrong at receiving (office)
- An office receives toner and types lot TN-0O4 instead of TN-004.
- Find it on the Lots board and press the pencil.
- Correct Lot number, type Typo at receiving in Why are you changing it? and press Save changes.
5 · Opening stock without lots (events)
- An events company loaded 4,000 wristbands with a spreadsheet, without lot numbers, but wristbands are lot-tracked by color batch.
- On the Lots board, press Assign lots to untracked stock and pick the warehouse row.
- Assign 2,500 to lot BLUE-26 and press All remaining for lot GOLD-26.
The Item Master list
The Item Master is your catalog. Tansi describes it as Your product catalogue — products, assets, suppliers and stock levels in one place. Every other page in the module, from requests to receiving to counts, works with items that exist here. Open it from Stock › Item Master.
Anyone with access to the Item Master can browse it. The buttons that change things — Add Item, Find missing pictures, edit, deactivate and delete — appear only for people who may edit it.
The top of the page
| What you see | What it tells you |
|---|---|
| Find missing pictures | Looks up product photos by barcode for items that have none. See Pictures, documents and safety data. |
| Add Item | Opens a blank item form. |
| Total Items | How many items the list has loaded with the current status filter. |
| Active | How many of those are active. |
| Inventory / Assets | The split between stock you use up and things you keep and maintain. |
The status filter starts on Active, so when the page opens Total Items and Active show the same number. Set the status filter to All statuses to count inactive items too.
Cards or table
Two small icons on the filter bar switch the view. Cards is the default and shows a photo for each item. Table packs more items on screen and can be sorted and exported. Fit and Fill change how photos sit in their frame: Fit shows the whole picture, Fill crops it to fill the space. The round arrow button reloads the list.
Clicking a card or a table row opens the quick view, a panel that slides in from the right with the essentials. The full item page is one click further. See Quick view and the item page.
What a card shows
- The photo, or a placeholder, with an Active or Inactive label. Hover over Inactive to see when and why the item was deactivated.
- The name, then SKU … (or No SKU) and the unit of measure.
- A lots link such as 3 lots · next expiry 2027-02-01, when the item has lots and you may see the Lots page. It reads expired when the nearest date has passed and none in stock when every lot is used up. Click it to open the Lots page for that item.
- Child of … when the item belongs to a generic parent item.
- Chips: Critical, Controlled, Hazardous, Credit return, Parent, Needs review, Asset or Inventory, the category path (for example Cleaning › Floor care), the department, and Reorder N when a reorder threshold is set.
Table columns
| Column | Shows |
|---|---|
| (photo) | A thumbnail. Click it to see the picture larger. |
| Name | The name, flag chips, Needs review, a Child of link and the start of the description. |
| SKU | Your code, the primary barcode as BC: …, and the lots link. |
| Category | The category path, and Department: … when one is set. |
| Classification | Inventory or Asset. |
| Unit | The unit of measure, with (N/pkg) when one unit holds more than one. |
| Storage | The storage type, such as Refrigerated. |
| Location | The item's default location. |
| Preferred Supplier | The supplier marked preferred on the item. |
| Reorder | The reorder threshold. |
| Status | Active or Inactive; hover for the deactivation reason. |
| Actions | View details, Edit Item, Deactivate (keeps stock and history) and Delete permanently (refused while inventory or history exists). |
Click a column heading to sort by it. The export menu above the table saves the rows you are looking at, with the filters you used written into the file. It adds columns the screen leaves out, such as Family, Needs Review, Description, Barcode, Department and Units/Pkg.
Flag chips and what they mean
| Chip | Meaning |
|---|---|
| Critical | The item must never run out. It feeds the Critical Items page. |
| Controlled / Restricted | The item takes the controlled approval route. Cards call it Controlled; the table, quick view and item page call it Restricted. Same flag. |
| Hazardous | Shown on cards for hazardous items. |
| Refrigerated | The storage type is named Refrigerated (table and item page). |
| Parent | A generic item that is never stocked itself; its child items are. |
| Non-stocked | Bought to order from a vendor when someone requests it. |
| Credit return | The vendor takes it back for credit, so send it back instead of throwing it away. |
| Needs review | Created from a barcode lookup or import and not yet checked by a person. |
The Refrigerated chip appears only when the item's storage type is named Refrigerated (capital letters do not matter). A storage type named Fridge or Cold room gets no chip.
If your workspace has each team maintain its own catalog, people see every item they may order but can only change items owned by their own locations. On other teams' items the edit, deactivate and delete buttons are not there.
Searching, scanning and filtering
The search box at the top of the Item Master reads Search or scan — name, SKU, barcode or lot…. Type and pause, or press Enter, and the list updates. A handheld scanner works too: it types the code and presses Enter for you.
How a search is read
- Tansi first checks whether what you typed is a barcode registered on an item. It understands plain codes, retail UPC and EAN numbers and the long GS1 codes on unit labels.
- If it matches, the list shows only that one item and a message says Barcode matched …. This happens even if the item is inactive or your filters would normally hide it.
- If not, Tansi searches names, SKUs, barcodes and lot numbers as text.
- If nothing matches, you see No item matches …, or for something that looks like a barcode No item has the barcode … Register it on the item's Barcodes tab.
Scan the product in your hand and the Item Master jumps straight to it, active or not. If the scan finds nothing, the code is not registered yet: open the right item and add it on the Barcodes tab so the next scan works.
The filters
| Filter | Choices | Notes |
|---|---|---|
| Classification | All · Inventory · Assets | Inventory is stock you use up; assets are things you keep. |
| Status | All statuses · Active · Inactive | Starts on Active. |
| Family | All families · Parent items only · Child items only · Not in a family | For generic items and the products under them. |
| Department | All departments · each department · No department | Appears only when at least one loaded item has a department. |
| Category | A searchable list of categories | Shows only categories your items use, indented under their parents, each with an item count. Picking a category includes everything filed beneath it. |
| Needs review | On / off | Shows only items still waiting for someone to check them. |
Filters combine. Assets plus Inactive plus a category shows retired assets in that category. The count beside the search box, N of M items, tells you how many survive the filters.
When nothing is left, the page says No items found and suggests Try adjusting your filters or add a new item. After a barcode search it says No item has this barcode registered. Add it on the item's Barcodes tab, or clear the search.
Because the status filter starts on Active, a typed name search will not find a retired item. Switch the status to All statuses or Inactive first. A barcode scan is the exception: it finds the item whatever its status.
Example
A facilities coordinator needs every floor-care product. She picks Cleaning › Floor care in the category filter, switches to Table, sorts by Reorder, and exports the list for the supplier review. Child categories under Floor care, such as Floor care › Wax, are included automatically.
Quick view and the item page
The quick view
Click any card or row in the Item Master and a panel slides in from the right. It is read-only on purpose: it shows the essentials so you can check something without leaving the list. The same panel opens from Stock Levels and the Access Center, even for people without Item Master access.
| Part | Shows |
|---|---|
| Header | Photo, name, SKU, unit and category, Active/Inactive, Child of …, Needs review and flag chips. |
| See details page / Edit | Shown only to people allowed to open or edit the item. |
| Basic information | Description, brand, barcode, classification, storage, default location, units per package, the thresholds that apply where the stock is, and on hand with the busiest locations. |
| Safety | Linked safety data sheets with supplier, signal word and status. |
| Alternatives | Items that can stand in for this one. |
| Child items | Generic items only: the products under it, in preference order, with on hand. |
| Attachments | File names; Open the details page to download or add files. |
| Suppliers | Supplier, their code and lead time, with a Preferred star. |
The quick view never shows prices. The thresholds line names its source: a location's own levels, its site's, or Main — … for the item's default levels.
The item page
See details page, the eye icon in the table, or a link anywhere in the module opens the full item page. Across the top sits an action strip:
| Button | What it does | Who sees it |
|---|---|---|
| Deactivate / Activate | Retires the item with a reason, or brings it back. | Editors |
| Delete | Removes an item that was never really used. | Editors |
| Edit | Opens the item form. | Everyone in the strip; editors also get an Edit button in the header |
| Copy | Creates Copy of … and opens it for editing. | Editors |
| Print labels | Prints a label for the primary barcode. | Everyone |
| Show barcodes | Jumps to the Barcodes tab. | Everyone |
| Asset relationships | Opens the matching asset in Maintenance. | When the item is an asset with a Maintenance record |
| … menu | Open stock ledger, View by location, View lots. | Everyone |
Below the strip is the header: the photo gallery (click to enlarge, thumbnails to switch), Asset or Inventory Item, the name, SKU, barcode and unit, status and flag chips. A row of facts follows: Category, Classification, Storage, Default Location (full path), Owned by, Unit / Pack, Item Type, and Subcategory and Project when set.
The side panel
| Card | Shows |
|---|---|
| Available Stock | What requests can take, in the item's unit. Underneath: on hand, a link to the reserved quantity (opens Reserved Stock for this item), and any quantity in held or expired lots. A badge reads Out of stock, Reorder or Healthy, then the six locations with the most available. |
| Preferred supplier | Supplier, price, lead time and supplier SKU. Only for people allowed to see costs. |
| Reorder Thresholds | Min, reorder and max, and one sentence such as On hand 40 — at or below the reorder point of 50. |
The big number is available stock. The badge and the threshold sentence use on hand, the same measure Reorder Suggestions uses. An item with 100 on hand, 90 reserved and a reorder point of 50 shows 10 available but a Healthy badge.
When an item belongs to another team's catalog, an editor sees This item is in another team's catalogue (…). Only the people assigned there can change it. Opening its edit form sends them back to the item page with the same message. Opening or wasting containers is stock work and still follows the Item Master grant.
Item page tabs: stock, history and containers
The item page has up to thirteen tabs. This section covers the four about quantities: Locations, Packaging & Stock, History and Containers. Generic (parent) items show their child products' figures, one row per child, with a Total (all children) line.
Locations
On-hand by location lists every place the item sits:
| Column | Meaning |
|---|---|
| Location | Where it is. Generic items add a Child item column. |
| Storage area | The cabinet, drawer or shelf inside the location, or Unassigned. |
| On hand | Everything physically there. |
| Quarantined / Suspended / Recalled | On hand but held in a lot that must not be used. |
| Reserved | Promised to an open request. |
| Available | What can actually be used. |
Stock Ledger opens the transaction history for this item. Edit Locations (editors) opens the item form on its Locations tab. If you can see only some locations, the table says None where you can see stock. Other places hold some. or adds Also in stock at other places.
The Location map pins each stock location; scroll-wheel zoom is turned off so the page scrolls normally. Locations on a floor plan get their own plan view, and clicking a pin opens that location's map. Per-location thresholds appears when any location has its own min, reorder or max.
Packaging & Stock
A read-only summary of everything that decides how the item is counted, ordered, received and restricted:
- Packaging & storage: unit of measure, whether it contains multiple units and, if so, the container, units per container, Expires after opening and whether container barcodes are auto-generated; otherwise Uses / doses per unit. Storage type and default location.
- Stock levels & ordering: Minimum, Reorder at, Maximum, Preferred vendor, Minimum order qty, Order multiple, Lead time and Stocked item (No — order on demand for procure-to-order items), plus per-location overrides.
- On hand: on hand, available, held, and for multi-use items a plain count such as 3 vials + 4 doses (34 doses) or 2,000 (20 × 100). Breakdown by location jumps to Locations.
- Receiving requirements: lot number, expiry date, serial number and any custom fields, each Required or Optional.
- Restrictions & risk: Restricted, Critical, High risk, Requires SDS, and the restriction reason.
History
The latest movements in and out: When, Type (with a link to the request when there is one), From, To and Quantity. Click a movement to see its full record beside the list: quantity, unit cost (if you may see costs), storage areas, lot, reference number, external purchase order number, wastage reason, who recorded it, who it was issued to, and the reason typed. See full history opens the ledger when there are more. Generic items list the latest 25 movements of each child in folding panels.
Containers
This tab appears for items that hold more than one dose or use. It lists each tracked container (vial, box, drum, spool) with its Barcode, Lot, Location, Status, Remaining (for example 6 / 10), Wasted and Open expires. Turn on Include used / wasted to see finished ones too.
| Status | Meaning |
|---|---|
| Sealed | Not opened yet. |
| Open | In use. Open expires counts down, for example 5h 20m, then reads Overdue. |
| Used | Its remaining count reached zero. |
| Wasted | The rest was thrown away and recorded as waste. |
| Expired | Ran past its time. |
Two buttons work a container. The open-lock icon, Mark opened — starts the post-open expiry clock, appears on sealed ones. The sweep icon, Waste remaining contents, opens Record Waste: it says how much will be removed, asks for a Waste reason (Expired after opening, Expired, Cold chain / temperature excursion, Damaged, Spoiled, Recall, Quarantined, Contaminated, Discarded or Other) and optional Details, then Record Waste.
Containers are created when stock is received, or adjusted upward, with a container count. Until then the tab says No tracked … yet. Day-to-day opening and dosing happens on Withdraw Supplies; see Dispensing: opening a unit and its clock.
Words like dose, vial and dispense come from health care, but dispensing is not only for medicine. Any item that is opened once and used a little at a time fits: a drum of floor cleaner poured into buckets, a spool of cable cut to length, a box of 12 hard hats handed out one by one, a bottle of sealant that hardens a week after opening.
Item page tabs: reference and safety
| Tab | What it holds |
|---|---|
| Overview | A panel for who holds the item, the Description (No description provided. when blank), Notes, Tracking & safety (contains multiples, per container, open expiry, lot tracking with the lots link, expiry tracking, requires SDS) and Category Fields, the custom fields your category adds. |
| Alternatives | Substitute items in priority order with notes and status. Editors get Manage Alternatives. |
| Child items | For a generic item, its products. For a child, which parent it belongs to. Otherwise a note that it is not in a family. |
| Attachments | Records and documents. Editors can add and remove them here. |
| Safety | The safe handling procedure and the linked safety data sheets. |
| History | Movements in and out (see the previous section). |
| Forms | Forms assigned to this item or asset. |
| Barcodes | Every registered barcode, with image, print, and (editors) add, generate, edit and delete. |
| Smart Scan | Whether QR, NFC and RFID tags are allowed for the item. |
| Suppliers | Who sells it and at what price. Only for people allowed to see costs. |
Category fields
If the item's category has custom fields, their values appear here. A field hidden by its branching rule, or marked hidden, is left out. On a child item, values inherited from the parent carry the caption from the parent item, and parent-only fields appear under From the parent item, ….
Child items
On a generic item the table lists each product with its photo, SKU, brand and unit, its priority, what is available and its status. Click a row to see the product beside the list: brand, SKU, barcode, unit and pack, preferred supplier, price (cost viewers only), on hand and available, with Open item details. Manage Child Items opens a dialog to add, reorder and remove products. If no products are linked, a warning says requests for this item cannot be fulfilled until one exists.
Attachments
Editors see the document editor. Add Document asks for a Type (Record or Document), a Description and up to 10 files of 20 MB each (PDF, images, Word, Excel or text). Done adds it to the list; Save Documents saves the list. Others see tiles they can preview and download. Generic items also show their products' files under From child items.
In the document dialog, Done only puts the document on the list. Nothing is stored until you press Save Documents. Leave the page first and the new document is lost.
Safety
The Safe Handling Procedure shows a code, a title, estimated minutes and numbered steps; editors can change it and press Save. A generic item also lists each product's procedure with an Open button. Safety Data Sheets lists linked sheets with hazard pictograms, product (a link to the SDS library), supplier and Active or Archived. Editors can Attach SDS or detach one (Remove the link to … from this item?). An item that requires an SDS but has none shows ⚠ Flagged High Risk — no SDS attached yet.
Barcodes and Smart Scan
The Barcodes table shows Value (click to see the bars), Type, Label, Counts as (Single unit, or for a package code something like box × 12) and Primary. Clicking a value, or the eye icon, opens a popup with the bars drawn large, the value, the barcode type (CODE128 when none is set), its label, a Primary chip where it applies, and Print label and Close buttons — handy for checking a shelf label against what Tansi has on file. Each row can also print a label, and for editors be edited or deleted after a confirmation. A generic item lists its products' barcodes too — scanning any of them lands on that product. Smart Scan shows QR Code, NFC and RFID as Enabled or Disabled.
Suppliers
The table lists Supplier, Supplier SKU, Price, Taxable, Account, Landed unit cost, Last received (what a delivery actually cost, with its date), Lead time and Preferred, preferred first. Landed unit cost is the price plus the item's product fees plus its taxes on the price when the supplier charges them. A generic item shows Product prices for each child with a total, its own family-level suppliers, and every child's suppliers.
The Suppliers tab and the price card in the side panel appear only for people your workspace lets see costs. Everyone else sees no prices anywhere on the item page or the quick view.
Creating an item: the basics
Press Add Item on the Item Master. The form opens as New Inventory Item with these tabs: Overview, Locations, Packaging & Stock, Notes & status, Smart Scan and Suppliers. Alternatives, Attachments, Safety and Barcodes appear once the item has been saved, because they attach things to an item that must exist first.
Start from a barcode
A new item form starts with Look up by UPC / EAN. Scan or paste the product's barcode and press Look up. Tansi asks an online product database and fills in what it finds:
- the name and description, only where you have not typed anything yet;
- the brand and the barcode;
- the product's specifications, added to Notes;
- a category suggestion, Go-UPC suggests: …, with a picker to map it onto your categories;
- a photo, shown as Product photo found and attached when you save. Press Don't use it to drop it.
If the code already belongs to an item in your workspace, Tansi says so and offers Open existing. If the database has never heard of it, you see … not found in Go-UPC. Enter the details manually. If you scan a unit label that carries a lot or expiry, Tansi looks up only the product part.
Opening a new item from Scan & Receive works the same way and goes one step further: when the scanned label carries a lot, expiry date or serial number, the matching receiving requirements are switched on for you, with a message saying so. Untick them if they are wrong.
Core Information
| Field | Notes |
|---|---|
| Item Name | Required, up to 200 characters. Must be unique in the workspace. |
| Description | Up to 500 characters. |
| SKU / Internal ID | Your own code, up to 100 characters. Must be unique in the workspace. |
| Barcode | Read-only: Synced from primary barcode. Manage barcodes on the Barcodes tab. |
| Brand / Manufacturer | Up to 200 characters. |
| Category | A top-level category. Changing it clears the subcategory and reloads the category fields. |
| Subcategory | Any category beneath the chosen one, shown as Child › Grandchild. Select a category first., No subcategories exist for this category. or Optional. |
| Department (optional) | Who the item is kept for. Pick one, or type a new name to add it on the spot. |
| Item type | Goods or Services. Used by supply approval routing. |
| Classification | Inventory (stock that gets used up) or Asset (things you track and maintain). |
| This is a generic item | Inventory only. Turn on to group products from different suppliers under one name. See Generic items, child items and alternatives. |
| Project | Optional. Projects are created in the Projects module. |
Category fields
When the category or subcategory has custom fields, a Category Fields block appears with one box per field: text, number, date, a yes/no, radio buttons, check boxes or a pick list. Fields with a branching rule appear only when the answer they depend on is given.
If you fill in a field and then change an earlier answer so that the field's branching rule hides it, the hidden field's value is dropped when you save.
On a child product of a generic item, a read-only block From the parent item, … shows the parent's values. Fill the same field above to give the child its own value.
Notes & status
Notes holds up to 2,000 characters. After the first save this tab also has the Active switch and Needs review, which Tansi sets on items made by a barcode import; clear it once the details are checked.
Saving
- Press Create Item, at the top or in the bar at the bottom. It stays gray until the item has a name.
- Tansi saves the item, says Item created successfully., and reopens it in edit mode so you can add barcodes, suppliers, pictures, documents and safety sheets.
- From then on the button reads Save Changes and Back to Item returns to the item page.
A duplicate name or SKU is refused with Error saving item: … and the reason. Saving an item as an Asset also creates its record in Maintenance, which is where Asset relationships on the item page leads.
The photo area on a new item is not editable. Save once, then add up to 10 pictures. The only exception is the barcode lookup photo, which is attached automatically on the first save.
Where an item lives and who sees it
Item location
On the Locations tab, Primary storage location is where the item normally lives. Search by warehouse, room, shelf or bin. Two buttons sit under it:
- New adds a location to the tree on the spot. It appears only for people who may manage locations; the Item Master permission alone is not enough.
- Set up map opens the map setup for the chosen location.
Owned by
Owned by decides whose catalog the item belongs to. Locations that order from the owner see the item in their catalog even when it is out of stock. Leave it empty and the item belongs to the warehouse its default location sits in; the item page then shows Its default location's warehouse.
When each team maintains its own catalog, Owned by offers only your own locations and the helper text says so. Leave it empty to use your own location. Only people assigned to the owner can change the item later.
Stock placement
Once an item has stock, Stock placement lists each quantity with its Location, Lot, Storage area and On hand. Pick a storage area (a cabinet, drawer or fridge shelf defined on the location) or choose a sublocation under Move into sublocation…. The pencil button lets you type a new storage area name.
Each change is a real stock movement, recorded in the ledger. Only the available quantity moves: Tansi reports Moved 12 to Shelf B — 3 reserved stayed put. A row whose stock is all reserved cannot be moved and says All quantity is reserved — nothing can move.
Advanced item map override
Use this folding panel only when the item itself needs its own map pin or a GeoJSON shape, separate from its storage location — a generator parked at a job site, for example. It offers Pin Location or GeoJSON Overlay and a Location Name.
Shown to
On the Packaging & Stock tab, under Restrictions & risk, Shown to decides who sees the item in their catalog and can order it on a supply request:
| Choice | Effect |
|---|---|
| Everyone its owner shares it with | The default. |
| Only some kinds of location | Pick the Kinds of location, for example Nursing Station and Health Centre, or Site office and Yard. The owner's own team always sees it. |
| Only its owner's own team | Nobody else can see or order it. |
With Only some kinds of location and nothing ticked, the box turns red (Pick at least one kind of location.). If you save anyway, the item is saved as Everyone its owner shares it with.
Packaging, multiples and stock levels
The Packaging & Stock tab decides what your stock is counted in and when Tansi suggests ordering more. Its first card is Packaging, Storage & Stock.
Unit and multiples
Unit of Measure is the unit the item is counted in: Each, Box, Bottle, Liter. Next to it, Contains multiple units says whether one container holds several units you count separately.
| Contains multiple units — ON | OFF | |
|---|---|---|
| Fields | Container name (up to 50 characters, such as vial, box, package), Units / uses per container, Expires after opening (hours), Generate a barcode for each received container | Uses / doses per unit |
| Stock is counted in | The units inside: a box of 12 counts as 12 | Whole units: a bottle of 100 counts as 1 |
| Expiry after opening | Yes, the hours you enter | No |
| Typical for | A vial of 10 doses, a box of 12 hard hats issued one by one, a drum of cleaner poured out by the liter | A bottle of 100 tablets, a box of 200 gloves, a roll of tape — counted as bottles, boxes or rolls |
Turning the switch on fills Container name with package if it is empty and ticks Generate a barcode for each received container. Turning it off keeps the count but clears the container name and the Expires after opening (hours) value.
Uses / doses per unit reads: How many individual uses one stocked unit yields — a Bottle/100 has 100, a Box/200 has 200. Leave at 1 for single-use items. Stock stays in whole units; the number tracks uses on an opened unit and powers the Uses figure on stock screens.
Expires after opening (hours) exists only when Contains multiple units is on, and switching it off clears it. A product that must be thrown away a set time after the seal is broken has to be set up this way. The full dispensing set-up, with worked examples, is in Items that hold more than one dose.
Words like dose, vial and dispense come from health care, but dispensing is not only for medicine. Any item that is opened once and used a little at a time fits: a drum of floor cleaner poured into buckets, a spool of cable cut to length, a box of 12 hard hats handed out one by one, a bottle of sealant that hardens a week after opening.
Storage Type says how the item must be kept, such as Refrigerated or Locked. Your workspace can add its own under Workspace Lists.
Stock levels
Stock Levels (default — applies to all locations) holds three numbers:
| Field | Meaning |
|---|---|
| Min Stock | Below this is urgent. |
| Max Stock | The most you want to hold at one time. |
| Reorder Threshold | At or below this on hand, the item starts appearing in Reorder Suggestions. |
| Minimum order quantity | An order must be for at least this many, and new order lines start here (blank = none). |
| Order multiple | Order quantities round up to this multiple (blank = none). Use 12 for an item sold by the dozen. |
Per-location overrides
Once the item is saved, Per-Location Overrides lets a site use its own levels. Press Add Locations, filter, tick the locations (Select shown ticks every one listed) and press Add location or Add N locations. Each row has Min, Reorder, Max, Order multiple, Lead (days) and Safety stock (days) (0 to 999). Leave a field blank to fall back to the default above. Saving the item also saves these.
A location can have only one row. Picking a location already used shows … is already assigned to this item., and saving with a duplicate is refused: Each location can only be assigned once. Remove the duplicate for ….
Generic items
On a generic (parent) item, a first card Decided by the child items explains that unit, packaging, container and lot settings come from whichever product is picked. Only the unit shown beside the combined total and the min, max and reorder levels matter on the parent. If the products use different units, a warning reminds you that the combined total adds them as they are, so set the levels in the unit you expect to count in.
Too low and you run out; too high and money sits on the shelf. Revisit it after a few months of real usage, and use per-location overrides where a busy site and a quiet one share an item.
Receiving requirements and restrictions
Receiving requirements
This card on the Packaging & Stock tab says what the person receiving a delivery must record. Turn these on for items where you need to track lot numbers and/or expiry dates at receive time.
| Switch | Effect at receiving |
|---|---|
| Require lot number when receiving | A lot number must be entered. Recalls and quarantine then work by lot. |
| Require expiry date when receiving | An expiry date must be entered for each lot received. |
| Require serial number when receiving | A serial number must be entered for each one. |
| Three custom rows | Switch one on, name it (up to 100 characters, such as Color batch or Calibration certificate), and tick Required when receiving if it must be filled in. |
Switching a custom row off clears its name and the required tick.
Turning on lot or expiry tracking for an item you already hold is safe. Stock already on hand sits in an (Unspecified) lot until it is issued; only new receipts must carry the details.
Restrictions & risk
| Switch | What it does |
|---|---|
| Controlled (restricted) — takes the controlled approval route | Orders for the item go through your controlled approval route whatever their value. A Restriction reason box appears (up to 500 characters); it is shown to requesters and in the chip's tooltip. |
| Critical — surfaces red badge and Critical KPI | Marks a must-never-run-out item. It gets a red Critical chip and appears on Critical Items. |
| The vendor takes this back for credit | Shows a Credit return chip wherever the item is listed, so people send it back instead of throwing it away. |
| Stocked (turn off for procure-to-order items) | On by default. Turn off for things you never keep on the shelf and buy only when asked; they show a Non-stocked chip. |
The card's own text says restricted items route through the Regional Nurse Manager approval workflow. That is the default wording; who actually approves is set by your workspace's approval workflows.
If the item's category, or a category above it, is set to Controlled substances, the switch is locked so you cannot change it, the item is saved as controlled whatever the switch shows, and the caption reads Set by its category: it is in a controlled-substances category, so it stays controlled while it is there. Move the item to another category, or change the category, to take the flag off.
Shown to, at the bottom of this card, is covered in Where an item lives and who sees it.
Safety data sheets and high risk
On the Safety tab, Requires SDS (items without an attached SDS are flagged High Risk) marks products that need a safety data sheet. Until one is attached, a warning reads This item is flagged as High Risk — no SDS has been attached. This tick is saved with Save Changes.
Example
A road-building company stocks a two-part epoxy that the safety officer must sign for. The stores lead turns on Controlled (restricted) with the reason Safety officer sign-off required, ticks Require lot number when receiving and Require expiry date when receiving, ticks Requires SDS, then attaches the supplier's sheet on the Safety tab so the High Risk warning clears.
This example comes from health care, but nothing here is limited to medical supplies. The same settings work for building materials, cleaning chemicals, office stock, event equipment or warehouse parts.
Suppliers, cost, fees and taxes
The Suppliers tab has two parts: what one unit costs when no vendor is chosen, and the vendors who sell it.
Standard cost, product fees & taxes
| Field | Notes |
|---|---|
| Item cost | Default cost per unit, before extras and taxes. |
| Product fees | Up to six per-unit fees that follow the product whoever sells it. Add product fee, then pick the Kind (Shipping / freight, Handling, Eco / environmental fee, Recycling fee, Duty / brokerage, Discount, Other), an optional Label, and the amount Per unit. |
| Taxes | Up to four. Add tax, pick the Tax type (required); the Rate fills in from the tax type and can be changed (0 to 100 %). Taxes apply to the item cost only. |
A receipt-style box on the right, Standard cost per unit, adds it up: item cost, each fee, Cost with fees, each tax on the item cost, and Total per unit. Freight, handling and duty that vary from order to order belong on the purchase order, not here.
A product fee of kind Discount is still added to the cost; amounts here cannot be negative. Fees with an amount of zero and tax rows with no tax type are dropped when you save.
Suppliers
Suppliers can be linked once the item is saved; before that the tab says Save the item first, then link the vendors that supply it here. The add row asks for:
| Field | Notes |
|---|---|
| Supplier | Active vendors not already linked to this item. |
| Supplier SKU | The vendor's own code for the product. |
| Price | What this vendor charges per unit. |
| Lead days | How long their deliveries take. |
| Account code | Only when your workspace has imported finance codes: the account purchases are coded to. |
| Charges the item's taxes | Ticked by default. Untick for a vendor who does not charge the item's taxes. |
| Preferred | The vendor offered first. Marking one preferred takes the mark off any other. |
Add supplier saves the link at once (Supplier added.). Each row in the list shows the price with two extra figures: Landed $…, the price plus the item's fees plus its taxes when this vendor charges them, and Last received $… · date, what the most recent delivery actually cost. The pencil edits a row in place (✓ to save, ✕ to cancel); the bin removes it straight away, with no confirmation.
If a vendor was entered by name only in an older set-up, Tansi says This supplier has no company record yet — open Suppliers and run “Link item suppliers”, then try again.
Generic items
A generic item carries no price of its own; it is bought as one of its products. Its Suppliers tab lists Suppliers of the child items and lets you name Suppliers that carry the whole family with a supplier SKU, lead days and preferred flag, but no price.
The side panel while editing
On an existing item, the right-hand panel shows On-Hand Stock with the top eight locations, Pricing & Cost (item cost, each tax, total, and the preferred supplier's price, lead time and SKU) and Reorder Thresholds. A generic item lists each child's price and a total.
Supplier links, edits and removals save immediately, not with Save Changes. The item cost, fees and taxes save with Save Changes. Costs on the item page are visible only to people your workspace lets see costs.
Barcodes, labels and smart tags
An item can carry several barcodes: the manufacturer's retail code, a case code, and labels you print yourself. Every scan anywhere in Tansi — the Item Master search, receiving, counts, withdrawals — looks them up. Barcodes are managed on the Barcodes tab of a saved item, on the form or on the item page.
Adding a barcode
- Press Add Barcode.
- Scan or type the Barcode Value (required, up to 500 characters), or press Generate for a new unique value starting BC-.
- Check the line Type: … — detected from the value. Tansi reads the type off the number: 13 digits is EAN13, 12 is UPC, 8 is EAN8, 14 is ITF14, anything else is CODE128. You do not choose it.
- Press Preview to see the bars.
- Add a Label / Description if useful, such as Vendor barcode or Warehouse A label.
- Set Scan counts as: Single unit, or Package / case for a code on the outer box.
- Tick Primary Barcode for the code shown on the item and printed on labels. Only one barcode can be primary.
- Press Add.
The Generate button on the tab itself skips typing: it opens the same dialog with a value made from the item's SKU (or ITEM) and the date and time, ready to add.
The Barcode field on the item's Overview always shows the primary barcode, or the first one if none is primary.
Warnings that do not stop you
- Paste a whole GS1 unit label (one that carries a lot, serial or expiry) and Tansi warns that the product's barcode is its GTIN, and that lot and expiry details are captured at receiving instead.
- A retail-type number (EAN13, EAN8, UPC, ITF14) with a wrong check digit gets … does not have a valid … check digit. Saved anyway; double-check the label if scans of it never match.
Internal codes are often non-standard, so neither warning blocks the save.
Package barcodes
A barcode set to Package / case counts as the item's units per package when scanned. On the item page the Counts as column shows it as, for example, box × 12. Use it for the code on a case so that one scan at receiving or counting books the whole case.
When you open an existing barcode with the pencil, the Scan counts as box opens on Single unit, even if the barcode was saved as Package / case. Set it again before you press Save, or check the Counts as column on the item page afterward.
On the item form the bin icon removes a barcode immediately. On the item page you are asked first (Remove barcode … from this item?).
Printing labels
The print icon beside a barcode prints a label with the bars, the item name and the SKU. Print labels in the item page's action strip prints the primary barcode (or the first one). With no barcode at all it says No barcode registered for this item — add one from the Edit page. On the item page, clicking a barcode value or the eye icon shows the bars on screen with a Print label button — handy for checking a shelf label against the system.
Container barcodes
For items set up with Contains multiple units, Generate a barcode for each received container labels every container at receiving, so each one can be scanned and traced on the Containers tab.
Smart Scan
The Smart Scan tab, headed Smart Tags, has three switches: QR Code Enabled, NFC Enabled and RFID Enabled. They record which kinds of tag this item may use later. As the tab says, These optional settings do not change receiving, stock, barcode, or request workflows.
Pictures, documents and safety data
Pictures
Pictures sit in the gallery at the top of the item form once the item is saved. The first picture is the Primary one shown on cards and in lists.
- Click the + tile, or drop files on it, to add pictures: PNG or JPG, up to 20 MB each, at most 10 per item.
- The star sets the picture you are looking at as primary; the bin deletes it.
- Changes save by themselves; a small note reads Saving…, Saved, or Save failed — retry.
- Manage all opens Manage Images: Add images, drag to reorder, crop, rotate, move earlier or later, set as primary, delete, or switch on Select to delete and remove several at once. Press Save changes.
Too many files: Image limit reached (10). Remove some before adding more. A file over the limit: …: exceeds the 20 MB size limit.
Find missing pictures
Find missing pictures on the Item Master, or Find a picture on an item page without a picture of its own, looks product photos up by barcode in an online product database.
- The dialog says how many active items have no picture and how many have a barcode it can search. Codes your workspace generated in-house are left out, since no database knows them; tick Search them anyway to include them.
- Press Search N items. A progress bar counts Looking up x of y…; Stop halts it.
- Review the matches: each row shows the picture, Our item and Found as. Untick any that show the wrong product.
- Press Add N pictures (or Use this picture for one item). The Status column marks each Added or gives the error.
Nothing is attached until you confirm, so a wrong match never lands on an item unseen. After three failed lookups in a row the search stops and asks you to try later.
Documents
The Attachments tab holds manuals, certificates, warranties, inspection records and photos. Add Document asks for a Type (Record or Document), a Description and up to 10 files of 20 MB each (.pdf, .png, .jpeg, .jpg, .doc, .docx, .xls, .xlsx, .txt). Press Done, then Save Documents. Grid and list views, preview and download buttons help you find a file later.
Safety data sheets
On the Safety tab, Attach SDS opens Attach SDS to … with two tabs:
| Tab | How it works |
|---|---|
| Upload PDF | Drop a PDF (max 10 MB). Tansi reads it (Analysing SDS…) and fills Product Name, Supplier, Product Code, Signal Word (None, Warning, Danger) and Emergency Phone. Check them; product name and supplier are required. Save & Attach adds the sheet to your SDS library and links it. |
| Select Existing | Search active sheets in your library by product, supplier or code, tick one or more (sheets already linked say Already linked) and press Attach (n). |
If the PDF cannot be read automatically, fill the fields in by hand. Only PDFs are accepted.
Safe handling procedure
The Safe Handling Procedure card holds a short step-by-step for handling the item: a Code (such as SHP-001), a Procedure Title, Estimated Minutes, and steps added with Add Step. Each step has a title and optional details with bold, italic and list buttons. On the item form you can also attach Procedure documents. Press the card's own Save.
The safe handling procedure saves with its own Save button; SDS links save when you attach or detach them; pictures save by themselves; documents need Save Documents. Only the Requires SDS tick waits for Save Changes. Very long procedures are refused with Procedure content is too long to save. Shorten the steps before saving.
Example
An event company adds a fog machine fluid. The coordinator scans the jug on a new item form, keeps the photo the lookup found, saves, then on the Safety tab uploads the supplier's SDS PDF and writes a three-step procedure: ventilate the room, wear gloves, wipe spills at once. The crew can read it on the item page before every show.
Generic items, child items and alternatives
Generic items and their children
Sometimes people ask for a thing, not a brand: nitrile gloves, medium, 2x4 stud, 8 ft, A4 copy paper. You may stock it from several suppliers, each with its own product, code, unit and price. A generic item (Tansi also calls it a parent) stands for the thing; its child items are the real products on the shelf.
- The parent is never stocked, received or counted itself. Its on hand is the sum of its children.
- The parent holds the min, max and reorder levels, so reordering fires off the true family total.
- A request for the parent is filled with one of the children; the first child in the order is offered first.
- Children may differ in unit, supplier and price. A child cannot be a parent, and belongs to only one parent.
- The parent's page gathers its children's pictures, alternatives, attachments, safety sheets, barcodes, suppliers and movements.
Making a generic item
- On the item form's Overview, with Classification set to Inventory, turn on This is a generic item. A Child items tab appears straight away, even on a new item.
- On Child items, search for the products and tick them. Each shows Eligible, or why not: Is a parent item or Already a child of …. Only active, non-asset items are offered.
- Press Add selected. On a new item, or one switched to generic since the last save, the button reads Add selected — linked on save and the picks wait under Linked when you save.
- Drag rows, or type a number in Order, to set the preference order.
- Set the min, max and reorder levels on Packaging & Stock, in the unit you count in.
- Save.
The table shows each child's SKU, brand, unit, preferred supplier, price, on hand and status, with a Total (all children). Remove from family unlinks a child. Category is optional on a generic item; each child keeps its own.
Until at least one child is linked, Tansi warns No child items linked yet — requests for this item cannot be fulfilled until at least one child exists.
From the item page, Manage Child Items opens a dialog that does the same: search, a Priority (1 to 99) for new picks, Add Selected, edit priorities, remove. Changes in the dialog save immediately; Close only closes the dialog.
Alternatives
An alternative is a different item that can stand in when this one is out of stock — a 500 ml bottle for a 1 L one, another brand of safety glasses. Alternatives are separate items with their own stock; they are offered as substitutes, in your order.
- Open a saved item's form and go to Alternatives.
- Type in Search items and press Search. Optionally type Notes for the added items, such as Only for indoor use.
- Tick the items (Select all visible ticks every one) and press Add selected.
- Drag rows or type an Order number to rank them. Edit a note in place; it saves when you leave the box.
- Use the Active switch to pause an alternative without removing it, or the bin to remove it.
Alternatives save as you go — they do not wait for Save Changes. On the item page, Manage Alternatives opens a dialog with the same controls plus a Priority for new picks. A generic item also shows its children's alternatives under From child items.
In the Manage Alternative Items dialog every add, switch and removal is saved the moment you make it. Cancel closes the dialog but keeps those changes.
This example comes from health care, but nothing here is limited to medical supplies. The same settings work for building materials, cleaning chemicals, office stock, event equipment or warehouse parts.
Retiring, deleting and copying items
Deactivate: the normal way to retire an item
Deactivating takes an item off every ordering list but keeps its stock, lots and history. Remaining stock can still be used down to zero by people allowed to handle inactive stock.
- Press Deactivate on the item page's action strip, or the block icon in the Item Master table.
- Type a Reason (required, up to 500 characters), for example discontinued by the manufacturer, replaced by the 20 L drum or recalled lot.
- Press Deactivate.
The reason and date are kept on the item and in the audit log. Hovering over the Inactive label anywhere shows Deactivated (date): reason.
Activate
On an inactive item, Activate asks Are you sure you want to activate …? and clears the reason. The Active switch on the form's Notes & status tab does the same.
Delete: only for items never used
Delete removes an item permanently, with its barcodes and supplier links. Tansi refuses while any stock is on hand or reserved anywhere, or while transactions, lots or request lines point at the item — the history must stay intact. In practice you can delete only an item created by mistake. Tansi shows the reason when it refuses; deactivate the item instead.
A deleted item is gone for good. If there is any doubt, deactivate it.
Copy
Copy on the item page asks Create a copy of …? You'll be taken to the new item to finish setup. and creates Copy of …, active, then opens it for editing. Rename it and add its own SKU.
| Copied | Not copied |
|---|---|
| Description, category and subcategory, category field values, unit, units per package, multiples and container settings, smart-tag switches, storage type, default location and owner, min, max and reorder levels, item type, classification, receiving requirements and custom tracking fields, controlled flag and reason, requires SDS, credit return, project | SKU, barcodes, notes, map details, suppliers, documents and pictures, lots, SDS links, the critical flag, department, Shown to, item cost, fees and taxes, minimum order quantity, order multiple, safe handling procedure, per-location overrides, alternatives, the generic-item switch |
A copy of a critical item is not critical until you turn the flag back on, and it has no supplier or cost. Work through the Packaging & Stock and Suppliers tabs before anyone orders it.
Use cases: the Item Master step by step
1 · A new consumable from a barcode (office supplies)
- An office manager opens Item Master, presses Add Item, scans a box of pens into Look up by UPC / EAN and presses Look up.
- Name, brand and a photo fill in. She picks Category Office › Writing and sets Department to Front desk.
- On Packaging & Stock she sets the unit to Box, Reorder Threshold 4, Max Stock 12.
- She presses Create Item. The form reopens; on Suppliers she adds the stationery vendor with its price and ticks Preferred.
2 · A product opened and used over time (cleaning)
- A janitorial lead creates Floor stripper, 20 L drum and on Packaging & Stock turns on Contains multiple units.
- Container name drum, Units / uses per container 20 (liters), Expires after opening (hours) 2160 (90 days), and leaves Generate a barcode for each received container ticked.
- Under Receiving requirements he turns on lot number and expiry date; on Safety he ticks Requires SDS and attaches the sheet.
- When drums arrive each gets its own barcode; the Containers tab shows each drum Sealed until someone opens one.
Words like dose, vial and dispense come from health care, but dispensing is not only for medicine. Any item that is opened once and used a little at a time fits: a drum of floor cleaner poured into buckets, a spool of cable cut to length, a box of 12 hard hats handed out one by one, a bottle of sealant that hardens a week after opening.
3 · One name, several suppliers (construction)
- A site storekeeper creates Drywall screws 1-5/8 in, turns on This is a generic item and, on Child items, adds the two brands the company buys.
- She drags the cheaper brand to the top so it is offered first, sets min 10 and reorder 20 boxes on the parent, and saves.
- Requests now name the generic item; the yard fills them with whichever brand is on the shelf, and reordering looks at both brands together.
4 · A controlled item (health care)
- A pharmacy lead opens an item filed in a category marked Controlled substances: the Controlled switch is already on and locked.
- She types a Restriction reason, turns on Critical, sets Shown to Only some kinds of location and ticks Health Center, then saves.
This example comes from health care, but nothing here is limited to medical supplies. The same settings work for building materials, cleaning chemicals, office stock, event equipment or warehouse parts.
5 · Retiring a replaced asset (events)
- An event company has replaced its old PA speakers. The equipment manager opens the item page and checks History and Locations: two speakers are still in the warehouse.
- She presses Deactivate, types Replaced by the 2026 line array, and confirms.
- The speakers vanish from ordering lists, but stay in stock until they are sold off, and their history stays.
6 · Cleaning up after a barcode import (warehouse)
- A warehouse lead turns on Needs review in the Item Master to see items created from barcode lookups.
- For each one he opens the form, fixes the name, picks the category and unit, and on Notes & status turns Needs review off before Save Changes.
- He finishes with Find missing pictures to fill in photos for anything still without one.
Categories and child categories
Categories group items: Cleaning › Floor care › Wax, Medical › Wound care, Electrical › Cable. They drive the category filter on the Item Master, can add custom fields to every item filed under them, can mark items as controlled, and can say which finance account purchases are coded to. Open Admin › Categories. The page is also listed in the Admin module.
The categories page
Inventory Categories shows the whole tree in one grid. A top-level category has a Root chip; a child shows Level N and an arrow; N beneath counts what sits under a category.
| Column | Shows |
|---|---|
| Icon | The category's icon. |
| Category | The name with its level. |
| Parent | The path above it, or Root. |
| Comment | Your note on what belongs here. |
| Company | The company the category belongs to. |
| Is Hidden? | Whether it is hidden from pickers. |
| Actions | Add Child, edit and delete. |
Search with Search category hierarchy... (names, comments, parent paths and companies), narrow with the Tenant filter, and read the totals in the chips and the footer. The export menu saves the grid.
Click a row to open its details panel: Global or Tenant scoped, Hidden or Visible, the comment, the Hierarchy (clickable parents and children), Identifiers, and a Fields summary with each field's type and whether it is required or shown in summary. Its footer offers Add child under … and Edit category, or Read only if you cannot change it.
Adding categories
| Button | What it does |
|---|---|
| Add Root Category | Opens Create Inventory Category for a new top-level category. |
| Add Child Category (top of page) | Opens Create Inventory Child Category, where you pick the parent from a list of full paths. |
| Add Child (on a row) or Add child under … | A quick dialog under that parent: icon, Name (required), Comment, Hidden from pickers. It shows how many fields the child inherits. Create saves it; Create & add fields saves it and opens its edit page. |
The create and edit pages
| Field | Notes |
|---|---|
| Description | The category name. Required. |
| Icon | Select Icon / Change Icon opens an icon picker. |
| Comment | What belongs here. |
| Company | Required. Cannot be changed once fields are added. |
| Project | Optional; available after a company is chosen. |
| Category ID, Cost Code, Other ID | Your own codes, up to 25 characters each. |
| Parent Category | Child categories only. Locked once the child has fields of its own, and cannot be changed when editing. |
| Finance account | Edit page. Purchases of items in this category are coded to it. Blank uses the parent category's. |
| Controlled substances | Edit page. See below. |
Then come the Category Fields, covered in the next section. Save with Create Category or Save Changes. Reset on the edit page puts back what was last saved. If something is missing, a list of problems appears at the top with the message Some required information is missing…
Controlled substances
Switching on Controlled substances makes every item in the category, and in every category under it, count as controlled: it shows the Controlled chip, takes the controlled approval route, and goes on a request of its own when a supply request is split by category. Before you save, the page warns Saving marks every item in it as controlled. or Saving takes the controlled mark off items that only had it from this category. If a category higher up is already controlled, it says so.
Use it for anything that needs the stricter route: explosives and detonators on a mine site, firearms for a security team, or high-value tools in a shared yard.
Deleting
The bin asks Are you sure you want to delete …? This action cannot be undone.
The Hidden from pickers switch exists only in the quick Add Child Category dialog. The create and edit pages keep whatever was set but have no switch for it.
Categories marked Global come with Tansi for every workspace. Their edit button is grayed out (You don't have permission to edit this category) unless your workspace owns them.
Category fields: your own item fields
Tansi's item form covers what most organizations need. When you need more — a hard hat's Size, a chemical's Flash point, a laptop's Warranty end — add a category field. Fields belong to a category. Every item filed under that category, or under any category beneath it, gets the field on its form under Category Fields.
Adding a field
- Open the category's create or edit page and choose the Company first; fields cannot be added without one.
- Press Add Field.
- Type the Field name, for example Brand, Color or Country of origin.
- Choose the Type (see below) and fill in what that type asks for.
- Tick Required, Hidden or Show in summary as needed.
- Optionally switch on Conditional logic (branching).
- Reorder fields by dragging the handle or with the arrows, then save the category.
Field types
| Type | Use it for | Extra settings |
|---|---|---|
| Text | Free-form text: descriptions, names, codes. | — |
| Number | Numeric values only. | Min value, Max value |
| Date | A calendar date. | Min date, Max date |
| Checkbox | A list where one or more can be picked on each item. | Type the options; at least one. |
| Radio buttons | A list where only one can be picked. | Type the options; at least two. |
| Custom Dropdown Category | A pick list taken from one of your custom dropdown lists. | Custom Dropdown Category to Show |
For Checkbox and Radio buttons, type each option and press Add option for the next. Tansi stores the options as a custom list for you.
Once a checkbox or radio field is saved, its options show grayed out: Options for an existing field can't be changed here. Get the list right before you save, or use a Custom Dropdown Category field, whose list you can keep editing under Custom Dropdowns.
The ticks
| Tick | Effect |
|---|---|
| Required | The field must be filled in. |
| Hidden | Kept off the item page's display. |
| Show in summary | Shown in summaries. At most three fields per category branch. |
Branching
Conditional logic (branching) shows a field only when another field on the same category has a certain answer. Switch it on and build the rule under Show … only when:. While the rule is not met the field stays hidden on the item form and is never required. The switch appears only when there is another field to depend on.
Example: a field Battery type appears only when Powered is answered Battery. Answering Mains hides it, and any battery type typed earlier is dropped when the item is saved.
Inheritance and limits
- A child category inherits all fields of the categories above it; its page lists them under Inherited from … (N) with Required, Summary and Hidden chips, and shows N inherited, N child-specific.
- Inherited fields show grayed out on the child; change them on the category that owns them.
- A category branch can have at most 50 fields in total, counting inherited ones. On a parent's edit page the count includes the largest child's own fields.
- Field names must be unique; Tansi lists duplicates and other problems at the top of the page.
When you create a child category, Tansi refuses more than 20 fields counting inherited ones (Total fields cannot exceed 20 including parent category fields…), even though the Add Field button allows more. Create it with fewer fields, then add the rest from its edit page, where the limit is 50.
On an existing category, saved fields are listed under Existing Fields and can be reordered or deleted; new ones go under New Fields.
Custom dropdown lists
A custom dropdown list is a named list of values — Hazard classes, Suppliers' colors, Vehicle makes. On its own it does nothing; it becomes useful when a category field of type Custom Dropdown Category uses it, so items in that category pick from the list. Open Admin › Custom Dropdowns.
Custom Dropdowns hold the values. The fields themselves, and their types, are set up on a category — see Category fields: your own item fields.
The list page
All Custom Dropdown Categories shows a total and a grid of Name, Date Created, Company and actions: view, edit, and delete. Create Custom Dropdown Category starts a new list; Export to Excel saves the grid. When there are none: No custom dropdown categories found.
Creating a list
- Press Create Custom Dropdown Category.
- Type the Name and choose the Company (both required).
- Press Create. Tansi says New Custom Dropdown Category added successfully! and returns to the list.
- Open the list with the view icon and press Create Value for each entry: type the Value and press Create.
A few names are reserved and refused: Employees, Roles, AspNetRoles and Duties.
The list's own page
… Details shows the created date and company, Edit List Details (name and company), and List Values: a grid of each value's number and text with edit and delete icons, and an export menu. Deleting a value asks Are you sure you want to delete …? This action cannot be undone.
You can also create a list on the fly from a category field: the field editor's company must be chosen first (Please select a company first to view or create custom lists.).
Only Tansi's own support staff can delete a whole list; administrators can rename it and manage its values. Lists marked global come with Tansi and say This is a global item. Only developers can edit it.
Workspace lists, funding sources and the audit log
Workspace lists
Admin › Workspace Lists holds the short lists people pick from on items. Rows marked Shared come with Tansi and are the same in every workspace, so they can't be changed here. Anyone who maintains the Item Master can maintain these lists.
| List | Used for |
|---|---|
| Departments | Who an item is kept for, and where withdrawals for delivery go. Picked on the item and on Withdraw for Delivery, where a new one can be added on the spot. Can carry a finance cost center once your workspace has imported finance codes. |
| Units of measure | What items are counted in. Add your own beside the shared ones. |
| Storage types | How an item must be stored (refrigerated, locked…). Add your own beside the shared ones. |
Pick a list with the buttons at the top. The table shows Name (with a Shared chip where it applies), Code, Cost centre and Description where the list has them, and Status On or Off. Your own rows have Change, Switch off / Switch on, and Delete while nothing uses them.
The add button names the list you are on. It opens a side panel with Name (required), and, depending on the list, Finance code (optional) — The short code the finance export writes, e.g. EA or BOX. Blank uses the name. — Description (optional) and Cost centre (optional). Renaming a row in use warns that the new name shows on the records that use it.
A row in use cannot be deleted. Switch off removes it from the pickers while the records that use it keep it, and you can switch it back on any time.
Funding sources
Admin › Funding Sources lists where money comes from — a grant, a program, a capital budget — so lots and order lines can be tagged for reporting.
| Column | Shows |
|---|---|
| Name | The funding source. |
| Code | A short code for tight report columns, such as P. |
| Scope | This tenant, or Global for ones Tansi provides. |
| Status | Active or Inactive. |
- Press New Funding Source.
- Type the Name (required) and a Code of up to 20 characters. Leave Active on.
- Press Create.
Edit a row with the pencil (Update to save). The block icon deactivates it after a confirmation. There is no delete; to bring one back, edit it and switch Active on. Inactive sources stay in the list.
Audit log
Reports › Audit Log is a read-only record of who did what, and when, in your workspace. Entries are recorded automatically and can't be changed. It always shows one workspace — your current one — and includes figures, filters, the entries themselves and an export menu. Item deactivations (with their reasons) and workspace list changes are among the actions recorded.
The audit log has its own permission, so you can give an auditor read access to the trail without giving them anything else in the module.
Data Import
Admin › Data Import loads data from Excel (.xlsx) or CSV files. It needs edit rights on the Item Master. The page, Inventory Data Import, has four tabs: Import, UPC Lookup, History and Templates.
What you can import
Import Type offers the kinds your workspace supports, among them: Item Master, Suppliers / Vendors, Location Hierarchy, Opening Stock, Barcodes, Item-Supplier Links, Financial Codes, Location Min / Max Levels, DOFA Authorities and Ship-To Locations (finance system). People (staff list) appears only for people who may create user accounts.
Import modes
| Mode | Effect |
|---|---|
| Insert Only | Adds new rows; leaves existing records alone. |
| Update Only | Changes existing records; adds nothing new. |
| Upsert (Insert + Update) | Adds what is new and updates what exists. The default. |
Running an import
- Choose the Import Type and Import Mode.
- Press Download Template and fill it in. The Templates tab has every template; required columns are highlighted in blue.
- Press Select File (.xlsx or .csv) and pick your file.
- Press Validate & Preview. Nothing is saved yet. Keep the page open; a large file can take a minute.
- Read Validation Results: Total Rows, Valid, Errors, Warnings, then the table of problems with Row, Field, Severity, Issue and Suggested Fix, and a Data Preview (first 50 rows).
- If there are no errors, Tansi says Ready to import N rows. (warnings do not stop you). Press Confirm & Import, or Cancel to drop it.
- Read the result: Import completed: N inserted, N updated, N skipped, N errors. with a table of anything that went wrong.
Confirm & Import appears only when validation finds no errors. Correct the rows listed, save the file, select it again and press Validate & Preview.
For People (staff list), a note explains that new people are created on hold: nobody is emailed or texted and they cannot sign in until released from their profile's Account tab. People already in Tansi are matched by email and only gain roles and locations they lack.
History
The History tab lists every import: Date, Type, File, User, Status, Total, Success, Errors and Warnings. Status reads, for example, Validating, Importing, Completed, CompletedWithWarnings, ValidationFailed, Failed or Cancelled. Refresh reloads it.
Locations underpin stock levels, transfers, pick lists and most reports. Import the location hierarchy and check it before you import opening stock; restructuring locations that already hold stock is painful.
A sensible order for a new workspace
- Location Hierarchy
- Suppliers / Vendors
- Item Master
- Item-Supplier Links and Barcodes
- Location Min / Max Levels
- Opening Stock
Importing by UPC
The UPC Lookup tab of Data Import turns a list of retail barcodes (UPC or EAN) into items. Tansi asks an online product database for each code and shows you what it found before anything is saved.
Looking codes up
- Paste the codes under Paste UPCs / EANs (one per line). Commas and semicolons also separate codes. A chip counts them.
- Press Look up. Up to 50 codes are fetched while you watch (Fetched x / y …). More than 50 run in the background: Job #N is running in the background. Press Refresh to check, or Cancel to stop it.
Reviewing the preview
Chips sum up the results: Found, Not found, Already exists, Invalid, Fetch failed. Each row has a tick, the Code, its Status (Exists: … names the matching item), an Action, and editable Name, Description, Brand, Category and UoM, the Image and Needs review.
| Action | Effect |
|---|---|
| Create | A new item with this code as its barcode. |
| Update existing | Changes the matching item. Press Review & merge to choose field by field; the button turns to Reviewed. |
| Skip | Leaves the code alone. |
Category can be picked from your categories, or built from the database's suggestion: under Go-UPC: … each part of the suggested path is a chip you click through ✓ use an existing category, + create a new one, or ⊘ skip it, then Apply. Clear chain undoes it. Needs review reads Yes while the category or unit is missing, and items created that way carry the Needs review flag in the Item Master.
Review & merge
For an existing item, Review & merge lists Name, Description, Brand, Category, Unit of measure and Notes / specs with the Current and Imported values; tick Use imported where you want the new one. A new photo can be added with Add this image to the item's gallery — existing images are kept. Press Apply choices.
Creating one item in full
The open-in-new icon on a row opens Create Item from Scanned Code: name, description, SKU, brand, category and subcategory, Equivalent to (optional), classification, item type, unit, units per package, storage type, default location, min, reorder and max, minimum order quantity, lot and expiry requirements, Critical, Stocked and notes. Equivalent to copies that item's category and links the two as alternatives for each other, along with anything already grouped with it. Create Item saves it; Create & open in Item Master saves it and opens the full form. The code becomes the item's primary barcode, and the row in the preview switches to Skip so it is not created twice.
Finishing
Press Confirm & Import. The result line counts Inserted, Updated, Skipped, Images attached, Images failed and Row errors, with any errors listed. View items opens the Item Master; Start another import clears the page.
Turn on the Needs review filter in the Item Master to work through imported items, complete their details and clear the flag.
Location Management: the location tree
Every stock figure in Tansi belongs to a location, so the location tree is the backbone of the module. Open it from Admin › Location Management. The page is called Inventory Locations: Manage hierarchical inventory location structures (Region → Warehouse → Room → Shelf → Bin). Those five levels are an example. There is no fixed number of levels; the footer tells you how deep your tree goes.
The header buttons
| Button | What it does | Who sees it |
|---|---|---|
| Hierarchy chart | Opens the whole tree as a zoomable chart, with stock and a PDF download. | Anyone on the page, once at least one location exists. |
| Who can see what | Opens the Access Center, where administrators decide who can see which locations and how locations share stock. | People who can edit locations and also manage roles. |
| Add Root Location | Adds a top-level location with no parent. | People who can edit locations and are not limited to particular locations. |
A new workspace shows No locations created yet and Start by adding a root-level location such as a Region or Warehouse. with a Create First Location button.
The tree
The left panel lists every location under the one it answers to, sorted the way people count: Shelf 2 comes before Shelf 10. Each row shows:
- An arrow to open or close the branch, when the location has locations inside it.
- An icon: a box means a storage spot that holds stock; a building means a grouping location.
- The name, then a gray caption with the tier, type and city, for example Tier 2 · Warehouse · Prince George. The type is left out when the name already says it.
- At the end: an Inactive tag, a truck icon for a ship-to location (Ship-to: vendors can deliver here), and a number showing how many locations sit directly inside it.
Hover over a row to see its full address and description. Click a row to show its details on the right. The tree rows have no buttons of their own; editing, adding and removing all happen in the detail panel.
Finding a location
- Search locations... matches names and descriptions. Branches open to show every match.
- Expand All and Collapse All (the two icons beside the search) open or close every branch.
- Storage spots N (green chip) shows or hides storage spots. They are shown by default; hide them to see only sites and buildings.
- Inactive N (amber chip) shows or hides retired locations. They are hidden by default. An inactive location that still has an active location inside it always stays visible.
A filled chip means that kind is shown. When everything inside an open branch is hidden, Tansi says so, for example 3 storage spots hidden. Turn on Storage spots above. The footer reads 92 active · 4 inactive and 5 levels deep.
Who can change what
You need edit permission for Location Management to change anything. On top of that, many roles are limited to the locations where they change stock. If yours is, you can only edit locations inside your reach, you can only pick parents inside your reach, and Add Root Location is hidden, because a top-level location belongs to nobody's reach in particular.
Removing a location
Select the location and press the red Deactivate icon in its panel. Tansi asks you to confirm with this message: If this location and its sub-locations have never had inventory attached, they will be deleted forever. If inventory has been attached, they will be made inactive and all stock in them will be set to 0 so the items can be added to another location.
- Never used: the location and everything under it are deleted. Location deleted forever.
- Used: they become inactive, their stock is set to zero and any items using them as a default location lose that default. The message counts the stock rows and item links cleared.
Removing a location that holds stock sets that stock to zero. It does not move it anywhere. Move or transfer the stock first, then remove the empty location. To bring a location back, edit it and switch Active on.
Stock levels, transfers, pick lists and most reports point at locations. Restructuring a tree that already holds stock is painful, so spend the time on the hierarchy first.
Adding and editing a location
Locations are added with Add Root Location on the page, or Add sub-location on a selected location's panel. Both open the Add Location dialog. Edit location opens the same dialog as Edit Location.
The main fields
| Field | What to enter |
|---|---|
| Name | Required, up to 200 characters. |
| Location Type | Optional, from your workspace's list of types (Warehouse, Clinic, Fridge…). |
| Tier | No tier, Tier 1, Tier 2 or Tier 3: Distribution level for tiered inventories (e.g. Tier 1 = provincial depot, Tier 2 = regional/zone depot, Tier 3 = community provider site). |
| Parent Location | The location this one sits inside, shown as a full path such as Warehouse → Room 2 → Fridge. A location cannot be put under itself or under one of its own children. |
| Description | Up to 500 characters. Searchable in the tree. |
When you start from Add sub-location, the new location is saved under the location you started from, even if you change Parent Location in the dialog. To put it somewhere else, create it and then edit it, or start from the right parent.
If the name sounds like a spot inside a room (fridge, shelf, bin, cabinet, drawer, cart, rack, tote, cupboard, locker or tray), Tansi shows “…” sounds like a storage spot. That is fine: shelves and fridges are child locations of the room that holds them. The hint reminds you to switch on Storage-enabled. It never stops you saving.
Operational details and finance
Show Operational Details opens a folded group (a Has data chip shows when it holds anything):
| Field | What it is for |
|---|---|
| Notes | Operational notes visible during transfers. Up to 1,000 characters. |
| Delivery Instructions | Instructions for shipment and receiving, such as a loading-dock door. |
| Ship-To location or Finance Ship-To Code | This place's code in your finance system. When your workspace has imported a Ship-To list you pick from it, and the helper shows the address on file or Not on the imported Ship-To list. Check the code, or import the list again. Otherwise you type the code. |
| Cost centre | Purchases received here are charged to it. Blank uses the nearest parent's. |
| Finance location | Your finance system's location value, which is not the ship-to code. Blank uses the nearest parent's. |
Address
Show Address opens Street Address, City, Province / State, Postal Code and Country Code (two letters, such as CA or US). When you create a location and pick a parent that has an address, Tansi copies it in for you. If you already typed something, a Copy from Parent button appears instead.
The switches
| Switch | Turn it on when… | What it changes |
|---|---|---|
| Storage-enabled | Stock physically sits here: a shelf, fridge, bin or cabinet. | Receiving and moving stock offer this spot as a destination. Leave it off for regions, sites and buildings. |
| Receives shipments (ship-to location) | A supplier's truck can deliver here. | The location is offered in a purchase order's Ship To picker and shows a Ship to chip. While no location is flagged, Ship To lists them all. |
| Receives deliveries in Tansi (on board) | The people here have started receiving in Tansi. | Stock sent here should go as a transfer so it lands in this location's stock. Withdraw for Delivery says so and offers to make one. While off, a warehouse sends here with Withdraw for Delivery and nobody receives it. |
| Show map | On by default. | Draws a map on the location's panel. Switch it off for spots inside a building. |
| Active | Edit only. | Switch off to retire a location; switch on to bring it back. |
Default project pre-fills the Project field on requests for this location. Requesters can still change it.
The Ship To picker names the facility a supplier delivers to, so it skips storage spots and everything inside them. If you flag a storage spot, or a location under one, as ship-to, Tansi warns you and the location will not appear. Flag the room, site or warehouse that takes the delivery instead.
Editors that save on their own
When you edit an existing location, the dialog also shows Request templates and Not allowed items. Changes there save the moment you make them, not when you press Save. They are explained in Ordering rules for a location.
Saving
Press Create or Save. Tansi confirms with Location created successfully. or Location updated successfully.
The Configure map button at the bottom of the edit dialog closes the dialog and opens the map page. Anything you typed in the dialog is lost. Save first, then configure the map.
The location panel: details, stock and people
Click a location in the tree and its panel fills the right side of the page. Before you pick one it says Select a location.
Header
The name, then chips: Tier, the location type, Storage, Ship to, Receives in Tansi and Inactive. Below is the path from the top of the tree. If you can edit this location, four icons sit on the right:
| Icon (tooltip) | What it does |
|---|---|
| Edit location | Opens the edit dialog. |
| Add sub-location | Opens the add dialog with this location as the parent. |
| Configure map | Opens the map and floor-plan page. |
| Deactivate | Removes the location (shown only while it is active). |
Under the header come the Ordering Schedule and, when there is anything to show, Details: description, notes, delivery instructions, address, Ship-To location, Cost centre and Finance location.
Stock at this Location
This table lists everything stored here and in every location inside it, so a site's panel shows the stock on all its rooms and shelves. A chip counts the items, and an amber chip counts low ones.
| Column | What it shows |
|---|---|
| Item | The item name; click to open the item. |
| SKU | Your item code. |
| Where | Here, or the name of the shelf or room inside this location, plus any storage area. |
| On Hand, Reserved, Available | Available turns red at zero or below. |
| Status | Out (nothing on hand), Low (on hand at or below the reorder level that applies at that spot) or OK. |
The reorder level used is the one set for that exact location if there is one, otherwise the nearest site's, otherwise the item's default. A clinic is not judged by the warehouse's reorder level. The export menu downloads the table, and Min / Max levels opens the levels drawer (see the next section). When nothing is stored here: No items are stocked at this location.
Assigned People
People who work at or belong to this location. For roles that are limited to their own locations, this list is what decides where they can see and change stock. Each person shows the date they were added (Since Mar 03, 2026).
- To add someone, search in Add person, pick them and press Add.
- To remove someone, press the red person icon (Remove). The history is kept.
Assigned Companies
Use this when contractors or partner organizations work at a location. Each company shows how many of its workers have access here (3 worker(s)).
- Search in Add company and press Add. Only active companies not already assigned are offered.
- The Workers — company name dialog opens straight away: Choose which of this company's workers get access to this location's inventory. Unchecked workers have no access here.
- Tick the workers (or use Select all / Select none) and press Save. Tansi reports how many assignments changed. The ticked workers also appear under Assigned People.
The group icon (Select workers) reopens the dialog. The red icon (Remove company) asks Remove company from this location? with a box, ticked by default, to Also remove this company's N worker(s) from this location. Untick it to keep the workers assigned as individuals. If the company has no workers with a user account, the dialog says This company has no active workers with a user account.
Adding or removing people and companies needs edit permission on the inventory module. Without it Tansi says, for example, You don't have permission to assign people to this location.
Sub-locations and the map
Sub-Locations lists the locations directly inside this one; click one to jump to it. At the bottom, when Show map is on, a small map shows the pinned spot, or the address if nothing is pinned (from address — use Configure map to pin the exact spot). The first time a location with an address but no pin is opened, Tansi looks the address up and saves the pin for you. A location with a floor plan shows This location has a floor plan configured. and View Floor Plan; one pinned on its parent's plan says Pinned on parent's floor plan.
Ordering rules for a location
Four tools on the location panel shape how a facility orders: its Ordering Schedule, its Request templates, its Not allowed items and its Min / Max levels. All of them need edit permission to change; anyone who can see the panel can read them.
Ordering Schedule
This section appears only to people with the order-schedule permission. Without a schedule it says No ordering schedule for this facility. Press Set up schedule to start one (it starts today).
| Field | What it sets |
|---|---|
| Frequency | Weekly or Monthly. |
| Every N weeks / Every N months | 1 to 52. Every 2 weeks means a fortnightly order. |
| Order day / Day of month | The weekday, or a day from 1 to 31. |
| Starts, Ends (optional) | When the schedule runs. Start is required. |
| Remind days before | 0 to 30: how many days ahead people are reminded the order is due. |
| Order template (optional) | The template to order from. Once the location has linked templates, it must be one of them; others show (not linked to this location) and cannot be picked. |
| Enabled | Switch off to pause the schedule without deleting it. |
Under Blackout dates, Add blackout adds a row with From, To and Reason, for holidays or closures. Press Save schedule (Ordering schedule saved.). A chip shows Next due; it updates when you save. Remove schedule deletes the schedule and its blackouts after a confirmation. Tansi refuses to save without a start date, or when a blackout ends before it starts. The Order Schedule page under Stock shows every facility's schedule together.
Request templates
Supply templates offered to requesters at this location. The default one is pre-selected when they start a request here. Pick a template in Link a supply template… and press the plus. The first one you link becomes the default (star); click another star to change it. The cross unlinks a template. Manage templates opens the template list. If none exist yet, Tansi suggests creating one from any supply request with Save as template.
The switch Only allow template items on supply requests locks ordering down: requesters here must pick one of the linked templates and can only order the items it lists. Anything else — including items not in the catalogue — is refused at submit.
If you switch template-only ordering on before linking a template, requesters at this location cannot add any items. Tansi warns you, but does not stop you. Link the template first.
Not allowed items
Items this location may not order. They are hidden from the request, transfer and purchase pickers for this destination, and refused at submit. Only someone with approval-bypass authority can add one anyway, with a documented reason that is audited and routed for approval.
- Search in Add an item that may not be ordered here… (assets are not offered).
- Optionally type a Reason (optional, shown to requesters), such as Order through the regional depot.
- Press the plus (Block this item at this location). It saves at once.
The table shows Item, Reason and Added (who and when). The cross (Allow this item again) removes the block; the history is kept. Blocks set on a parent appear below under Inherited from parent locations, with a Set at chip naming where. They are read-only here: change them at the location that set them. A block on a region therefore covers every site in it.
Min / Max levels
Min / Max levels in the stock table opens a side drawer for setting levels for this location only. Levels here apply only to this location and drive its low-stock alerts and reorder suggestions. A blank cell uses the item's default, shown greyed.
| Part | What it does |
|---|---|
| Rows | Items stocked directly at this location, plus any item that already has levels set here. |
| On hand | Red when out or below min, amber at or below reorder. |
| Min, Reorder, Max | Type a number, or leave blank to use the item default. |
| Planning columns switch | Adds Order multiple, Lead days and Safety days. |
| Set here, Low / out switches | Show only rows with levels set here, or only low and empty rows. |
| Cross on a row | Clears the row back to the item defaults (or removes a row you added a moment ago). |
| Add an item to set levels for… | Adds any active, non-asset item, even one not stocked here yet. |
| Save levels | Saves every changed row at once. Changed rows are tinted until saved. |
A row whose levels are out of order shows a warning such as Min 10 is above reorder 5. It is a warning, not a block. Closing with unsaved rows asks Discard unsaved levels?
Copy from… copies every level set at another location onto this one. Pick the source in Copy levels from. If this location already has its own levels, tick Overwrite levels this location has already set to replace them; otherwise they are left alone. Item defaults are never changed. Save or clear your edits first: Tansi will not copy over unsaved changes.
The hierarchy chart and PDF
Hierarchy chart on the Location Management page draws your locations as boxes, each under the location it answers to. It opens full-screen over the page, so closing it leaves the tree and your selection as they were. Select a box for its details.
The toolbar
| Control | What it does |
|---|---|
| Find a location | Searches names, types, ship-to codes, cities and descriptions. Matches are highlighted and the rest dim. The counter reads 2 of 7; use the arrows, or Enter and Shift+Enter, to step through. |
| Find an item | Lists items in stock at the locations you can see. Pick one and every box shows how much of it that location holds, with Low or Out against its reorder level. Stop showing this item clears it. |
| Storage spots, Inactive | Show or hide those boxes, starting from the page's own filters. |
| Expand all, Collapse all | Open or close every branch. |
| Download PDF | Opens the PDF dialog (below). |
| Zoom − and +, the percentage, Fit | Zoom; press the percentage to return to 100%; Fit shows everything. You can also drag to move, and hold Control while scrolling to zoom. |
Under the toolbar, a legend lists each location type with its color and count. White boxes are storage spots. When your administrator has set up supply relationships in the Access Center, a Supply: sentence says who supplies whom, and the warehouses are drawn as a tier above the locations they supply. When more than eight shelves or bins of one type sit side by side, they fold into one group box that opens into a grid.
Stock on the chart
Each box counts the items in stock in it and everything inside it (12 hold stock). The stock covers only locations you are allowed to see. If it cannot load, the chart says so and shows locations only.
The details panel
Selecting a box opens a side panel with the path (each step clickable), tags, Answers to (or Nothing above it. This is a top-level location.), Ship-to code, Address and Delivery notes. When a location has no address or notes of its own, the panel shows its parent's and says where they came from, for example Address of North Warehouse. Below are the items in stock there (up to 12, with a filter when there are more) and the locations it contains.
- Open in location list closes the chart and selects that location in the tree, ready to edit.
- Download this branch as a PDF starts the PDF from that location.
Downloading the hierarchy as a PDF
The PDF is For people who can't sign in yet, such as a new partner or an auditor. It draws the part you pick as in the chart, then lists every location in it with its ship-to code and address. Inactive locations are left out.
- In Start from, pick a location, or leave it empty for the whole workspace.
- Choose whether to Include storage spots (shelves, fridges and bins).
- Leave Add a list of every location with its address on for the address list.
- Press Download PDF. Tansi reports the file name and how many locations it contains.
An events coordinator looking for two-way radios can open the chart, pick the radios in Find an item, and see at a glance which venue boxes hold them and which are out.
Maps and floor plans
Each location can have a map pin and a floor plan. Open the Map Setup page with Configure map on the location's panel (or in the edit dialog, after saving). The page title is the location name followed by — Map Setup; the back arrow returns to Location Management. You can view this page with read access, but changing anything needs edit permission.
World location
Drop a pin on the map to set this location's outdoor coordinates. Search by address, or click anywhere on the map. The pin saves as soon as it is placed (Coordinates saved.). Clear coordinates removes it, and the location's map falls back to its address.
Floor plan
Upload a plan of the building or room: a floor plan image (PNG, JPEG, WebP — max 10 MB) or a PDF (max 25 MB / 20 pages). Press Choose file.
- An image uploads straight away.
- A PDF shows its pages as thumbnails: Pick a page to use as the floor plan. Only the first 20 pages are shown; split a longer PDF if you need a later page. Cancel goes back.
- Once uploaded, the plan shows its file name, size in pixels and upload date, with Replace and Delete.
Delete removes the floor plan as soon as you press it, along with its place on the page. Replace is safer: it reads the new file first and only then removes the old plan.
Placing locations on the plan
Under Locations on this floor plan, the left list shows every location inside this one that can be pinned, with N of N pinned at the top. If there are none: This location has no eligible descendants yet. Add children first, then return here to place their pins on the floor plan.
- Click a location in the list. Tansi says Click on the canvas to pin …
- Click the spot on the plan. Or type X % and Y % (0 to 100) and press Set pin.
- To adjust, drag the pin, or select it and use the arrow keys (hold Shift for bigger steps).
- The red cross beside a pinned location removes its pin. Open location map jumps to that location's own map page.
A location pinned on its parent's plan shows Your position on …'s floor plan on its own Map Setup page. That view is read-only; move the pin from the parent's page.
Floor plans also appear on an item's page, where clicking a pin opens that location's map.
Use cases: setting up locations
1 · A new warehouse with shelves (warehouse)
- On Location Management, select the region and press Add sub-location.
- Name it Kamloops Warehouse, type Warehouse, Tier 2. Open the address and enter it.
- Switch on Receives shipments (ship-to location), because trucks deliver here. Leave Storage-enabled off: the warehouse groups the aisles, it is not a shelf.
- Open Show Operational Details and add Dock door 3, 7 a.m. to 3 p.m. to Delivery Instructions. Press Create.
- Select the warehouse and add Aisle A under it, then Shelf A1, Shelf A2 under the aisle. For each shelf, switch on Storage-enabled and switch off Show map.
- Receiving into the warehouse now offers the shelves as places to put stock away.
2 · A construction company's job sites
A contractor runs three job sites and a yard. The yard is a storage spot that also takes deliveries from the lumber supplier; each site has a lockable container.
- Create Yard as a root location with an address and Receives shipments on.
- Create each site under a Job sites grouping location, with the site address, Default project set to the site's project, and Receives shipments on so suppliers can deliver direct.
- Under each site add Tool container with Storage-enabled on.
- On each site's panel, use Assigned Companies to add the subcontractor and tick the foremen who should see the container's stock.
- On the Job sites grouping location, add the company's diesel fuel to Not allowed items with the reason Fuel is ordered by the yard only. Every site inherits the block.
3 · Health centers that order every second Monday (health)
This example comes from health care, but the feature is not limited to medical use. It works the same way for building materials, office supplies, event equipment or warehouse parts.
- Select the health center. Under Ordering Schedule press Set up schedule.
- Choose Weekly, Every N weeks 2, Order day Monday, Remind days before 2.
- Add a blackout for the winter holiday week and press Save schedule.
- Under Request templates, link Clinic standard order; it becomes the default.
- Open Min / Max levels, set Min, Reorder and Max for the top items, and press Save levels.
- Open the next health center's panel, press Min / Max levels, then Copy from… and pick the first center. Adjust the few items that differ and save.
4 · An events venue on a floor plan (events)
- Create Convention Center with its address, then Hall A storage, Loading bay and AV room inside it, each storage-enabled.
- Press Configure map on the convention center and drop a pin on the world map.
- Upload the venue's floor plan PDF and pick page 2, the ground floor.
- Select each room in Locations on this floor plan and click its spot on the plan.
- Crew opening an item that is stored there can now see where in the building it is.
5 · Retiring an office storeroom (office)
- Move the storeroom's paper and toner to the new supply closet: with Move Stock if both are inside the same office, or with a transfer if they are not.
- Check the storeroom's panel shows No items are stocked at this location.
- Press Deactivate and confirm. Because the storeroom held stock in the past, it becomes inactive rather than being deleted, so its history stays readable.
Order feedback: how it works
An order feedback survey asks sites what they need before a buyer places orders. Instead of each site raising its own purchase request, the buyer sends one survey, sites fill in quantities, and Tansi totals the answers and turns them into draft purchase orders grouped by supplier. It suits seasonal or bulk buying: winter gear for every job site, a school year's office supplies, a flu-season order for every clinic.
This example comes from health care, but the feature is not limited to medical use. It works the same way for building materials, office supplies, event equipment or warehouse parts.
The stages
| Stage | What it means | How it gets there |
|---|---|---|
| Draft | Being set up. Responders cannot see it yet. | New Feedback Survey, or a copy with Use as template. |
| Active | Sent. Responders can answer from the start date. | Activate & Send. |
| Closed | No more answers. Vendor drafts can now be created. | Close Survey. |
| Completed | Finished and filed. | Mark Complete. |
Each responder also has a status: Not Started, In Progress (a saved draft, shown as Draft in some places) or Submitted.
Manage Feedback: the list
Buyers open Surveys › Manage Feedback. The page is called Order Feedback: Collect site feedback before creating purchase drafts.
- Tiles count Active surveys, Draft surveys, Submitted responses and Past due active (active surveys whose due date has passed).
- Search matches the title and description; Clear resets it. Chips filter by stage, with counts.
- Columns: Feedback Survey, Status, Due Date, Items, Responders, Responses (submitted of total) and Created. Active surveys come first, then the newest.
- Use as template (copy icon) creates a new draft named … - Next Cycle with the same items and responders, and opens it for editing. Open (or a click on the row) opens the survey.
- New Feedback Survey starts a blank one; Refresh reloads.
My Order Feedback
Responders find their surveys under Surveys › My Order Feedback, or Home › My Work. That page is described in Answering a feedback survey.
Building a feedback survey
New Feedback Survey on Manage Feedback, or Edit on a draft, opens the editor. It needs the order-survey permission. Back to Order Feedback leaves without saving.
Survey Details
| Field | Notes |
|---|---|
| Title | Required. |
| Description | Shown to responders. Say what the order is for and when it will be placed. |
| Start Date | Optional. Cannot be in the past. Responders cannot answer before it. |
| End Date | Optional due date. Cannot be before the start date or in the past. |
| Allow edits before deadline | Lets responders change a submitted answer until the end date. |
Tansi refuses to save a survey whose start date is in the past (Start date cannot be in the past.). When you edit an older draft, or a copy made with Use as template, change or clear the dates first.
Suggested Items — Optional
Suggested items pre-fill every responder's list. Leave the section empty and each site builds its own list from the catalog.
| Button or column | What it does |
|---|---|
| Load inventory | Opens the catalog browser to pick many items at once. Setting an already-suggested item to zero there removes it. |
| Add another item | Adds a row; search by item name or SKU. An item can only be suggested once. |
| Bulk scan | Scan barcodes one after another. Items outside the survey's catalog are skipped and counted. |
| Required | Star this item so stations see it as expected. Starred items show a gold star to responders. |
| Delete icon | Removes the row. |
Items requested for (destination location) is the default destination: where the requested items are going. It sets the stock shown while browsing, and is given to responders as you add them. Changing it moves every responder who had no destination, or had the old default, to the new one; responders you set individually keep theirs.
Site Responders
The location identifies where the requested items are going. Choose a default before adding responders, or set a different destination for each responder below.
- Add User: search and pick a person; the box clears so you can keep adding.
- Add by Role and Add Role: adds everyone with that role who is not already listed.
- Add All: adds every user in the workspace.
- In the table, change each person's Destination / Responding Location, or remove them with the delete icon.
Press Save Draft. Tansi confirms Feedback survey saved. and opens the survey's page, where you activate it.
For a multi-site survey, leave the default destination empty and set each responder's location in the table. The By Location tab then totals each site separately.
Running a survey and turning it into orders
Open a survey from Manage Feedback. The header shows the title, description, stage, Starts, Due, and how many items and site responders it has.
Buttons by stage
| Button | Shown when | What it does |
|---|---|---|
| Edit | Draft | Opens the editor. |
| Activate & Send | Draft | Makes the survey active. Recipients can access it from My Order Feedback; in-app notifications are sent best-effort. |
| Enter My Feedback | Active, and you are a responder who has not submitted | Opens your own answer page. |
| Use as Template | Always | Copies it to a new draft named … - Copy and opens the copy. |
| Close Survey | Active | Stops further answers. |
| Mark Complete | Closed | Files the survey as done. |
| Create Vendor Drafts | Not Draft | Enabled only when Closed or Completed, with submitted quantities. |
| Export Summary, Export Detail | Not Draft | Download Excel workbooks of the totals and of every answer. |
Activate & Send, Close Survey and Mark Complete act as soon as you press them. Check the items, responders and dates before activating.
Following progress
Tiles count Submitted, In Progress and Not Started responders, and Total Qty Requested. A Workflow row of chips shows the stages reached. The four tabs each have an export menu:
| Tab | What it shows |
|---|---|
| Item Totals | Each item with total quantity and number of responses. |
| By Location | The same totals per destination location. |
| Site Responses | Each responder: location, status, when submitted, how many items and total quantity. |
| Purchase Plan | Totals grouped by each item's preferred supplier. A group is marked Preferred vendor, or Needs vendor when its items have none. |
The tiles, Item Totals and By Location count saved drafts as well as submitted answers, so the numbers move while the survey is open. Close the survey before you rely on them.
Creating vendor drafts
- Close the survey.
- Press Create Vendor Drafts.
- If any group has no preferred supplier, the Create purchase draft dialog asks for one: Pick the vendor for this draft. The request will stay in Draft so procurement can review pricing, receiving details, and approvals before submitting. Search for a Vendor and press Create Draft. That one supplier is used for every group without a preferred supplier.
- Tansi creates one draft purchase order per supplier, with you as requester, a note naming the survey, and one line per item carrying the total quantity and the number of responses.
- Tansi reports Created N purchase draft(s). and opens the first draft. Find the others in My Requests.
- Add the delivery location, prices and anything else, then submit each draft for approval as usual.
The button does not remember that drafts were already made. Pressing it again creates a second set of drafts. If that happens, open each extra draft and cancel it with Cancel request in the request's menu, where your role allows it.
Answering a feedback survey
Open My Order Feedback from Home › My Work or from the module's Surveys section. When nothing is assigned to you: You have no order feedback surveys assigned to you.
Your list
| Column | What it shows |
|---|---|
| Feedback Survey | Title and description. |
| Status | The survey's stage. A draft says Not sent yet; a survey that has not started says Opens …. |
| Due Date | Red with (overdue) once passed. |
| Destination | Where your items are going. |
| Your Status | Not Started, In Progress or Submitted. |
| Last column | A pencil (Enter feedback), a check mark (You have already submitted this feedback) or a clock (This survey is not open for responses yet). |
Click a row or the pencil to answer. Rows you cannot answer do nothing when clicked.
Entering your quantities
The answer page shows the survey title, your status, the due and start dates, and then:
- Destination / Responding Location: where your items go. Locked when the buyer assigned it (This destination was assigned when the survey was sent.).
- Order Items: The starred rows were suggested for your station. Enter the quantity you need for each one — leave it at 0 for anything you do not need — then add any extra supplies at the bottom.
| Control | What it does |
|---|---|
| Qty with − and + | Whole numbers, zero or more. |
| Suggested | A gold star for items the buyer marked as expected, an outline star for other suggestions, Added for items you added. |
| Notes | An optional note per line, up to 500 characters. |
| Set all to 1 | Sets every line still at zero to 1. |
| Clear | Resets every quantity to zero. |
| Load inventory, Add another item, Bulk scan | Add items that were not suggested. Only lines you added can be deleted. |
Save Draft keeps your answer without sending it (Draft saved.); the buyer sees you as In Progress. Submit Feedback saves and sends it (Response submitted!). There is no confirmation step.
After you submit
Your quantities are shown read-only as Your Quantities (read-only), unless the buyer allowed edits before the deadline, in which case the page says You can edit until the deadline.
Even when edits are allowed, My Order Feedback shows a check mark instead of a pencil once you have submitted, and the row no longer opens. To change your answer, open the survey from the link in your notification or from a saved link to its page. If you cannot, ask the buyer.
Use case: winter gear for job sites (construction)
- The safety coordinator sends Winter PPE 2026 to every site foreman, with insulated gloves, toques and ice cleats suggested and starred.
- A foreman opens My Order Feedback, presses the pencil and enters 24 gloves, 24 toques and 0 cleats (the site has stock).
- He adds hand warmers with Add another item, notes Night shift crew and presses Submit Feedback.
- When every site has answered, the coordinator closes the survey and creates the vendor drafts.
Inventory Reports: the Dashboard
Reports › Inventory Reports is called Live analytics, printable documents, and plain-language questions over your inventory data. It has three tabs: Dashboard, Documents and Ask Tansi Intelligence. You need the inventory reports permission. Like every stock screen, the figures cover only the locations you can read; when that limits the totals, the dashboard says Totals are limited to the locations you can read. Someone with a wider location scope may see different numbers.
Finding a report by its code
Above the tabs, Report ID / barcode / request # takes a report ID, the barcode printed on any Tansi document, or a request number such as TR-2026-0002. Type or scan it and press Download. One match downloads at once; several open Choose report, a list with the report, request number and a Download button each. Every document carries its report ID barcode, so a printed report can be re-run by scanning it.
Dashboard filters
| Filter | Choices |
|---|---|
| Period | Last 30 days, Last 90 days (the default), Quarter to date, Year to date, Custom range (with From and To). |
| Location | One location and everything inside it, or All locations. |
| Expiry window | 30, 60 (the default), 90 or 180 days, for the expiring figures. |
Filters take effect when you press Apply. Export all (Excel) downloads every card as one workbook, and Print / Save as PDF opens your browser's print dialog with the filters and menus hidden. Press Apply before exporting so the workbook matches what you chose.
The figures across the top
| Figure | What it counts |
|---|---|
| Active SKUs | Items in stock, and across how many locations. |
| On-hand value | Stock valued at the lot's cost, or the item's purchase price when the lot has none. |
| Open Purchase Orders | Open purchases, and how many are awaiting receipt. |
| Low / out of stock | Item-and-location pairs that are low or empty. |
| Avg time to ship | From submitted to shipped, with how many requests it is based on. |
| Avg vendor lead time | From sent to the supplier to received. |
The cards
| Card | What it shows |
|---|---|
| Most ordered products | Units requested on supply and purchase requests submitted in the period. |
| Stock status | A donut of item-and-location entries by availability. Expiring means healthy but holding a lot inside the expiry window. |
| Vendor lead time | Average days from sent to received, per supplier, longest highlighted. |
| Average time to ship | Hours from submitted to first shipment, by week. |
| Inventory value by category | On-hand value per category. |
| Requests raised vs fulfilled | Two weekly lines, with totals for the period. |
| Reorder alerts | Every item and location at or below min or reorder, with a suggested quantity that tops up to max (or twice the reorder level), rounded to the order multiple, plus preferred supplier and lead time. Reorder suggestions opens that page. |
| Expiring lots | Lots with stock expiring within the window, already-expired lots first, with days left and lot status. Full nearing-expiry report jumps to the Documents tab. |
Each card has its own export menu (Excel, PDF or CSV of that card's rows). An empty card says why, for example Nothing shipped in this period. or Nothing is at or below its reorder level.
Inventory Reports: Documents
The Documents tab is a catalog of ready-made documents. Each card is one report: set its filters and download. Date filters start at the first of the current month and today. Every document carries a report ID barcode you can scan above to re-run it.
| Group | Report | Filters | What it gives you |
|---|---|---|---|
| Stock documents | Count Sheet (Excel) | Location | System on-hand with blank count and variance columns — take it to the shelf. |
| Reconciliation Worksheet (PDF) | Location | Printable count worksheet with blank physical, adjustment and reason columns. | |
| Transaction Report (PDF) | From, To, Location | Receive, issue, transfer and adjustment activity, with totals. | |
| Receiving | Warehouse Receipts Without a Purchase Order (PDF) | From, To, Location | Every receipt made without a purchase order: hold or release status, external PO number, supplier, delivery reference, receiver, item and lot, cost and audit totals. |
| Daily operations | Daily Inventory Report (PDF) | As of, Location | On-hand rebuilt as of a past date, by item. |
| Daily Withdrawal Reconciliation (PDF or Excel) | Withdrawal date, Location, Staff member, Item | Withdrawals grouped by their WDL reference, with time, recipient, the staff member who recorded it, item and lot, notes and daily totals. Staff member lists people who withdrew that day. | |
| Wasted Product Report (PDF) | From, To, Product, Location, Breakdown | Disposal totals and who recorded each event, when and why. Breakdown: Location groups or Individual locations. View & manage opens Waste Management. | |
| Product Return Report (PDF or Excel) | From, To, Location | Return shipments sent back up the hierarchy, per line. | |
| Expiry & lots | Nearing Expiry Report (PDF or Excel) | Expiring within + Unit, Location, Category, Product, Include quarantined, recalled and suspended lots | Stock expiring inside the window, in urgency bands by location, already-expired lots first. Open on lots board shows the same window on the Lots board. |
| Fulfillment documents | Pick List (PDF) | Request ID or Request # | Pick sheet in FEFO order with blank Qty Picked and Initials columns. |
| Packing Slip (PDF) | Request ID or Request # | Shipment paperwork: organization, addresses, lots and funding source. | |
| Order Set — from Order (PDF) | Request ID or Request # | A printable order from any live supply, transfer or purchase request. | |
| Order Set — from Template (PDF) | Template ID | The same from a request template; funding is left blank. |
The fulfillment cards accept the internal request ID or the request number, such as TR-2026-0002. If nothing matches, Tansi says, for example, Pick List was not found for request … Check the request number and tenant selection.; several matches open Choose report.
Receipts made without a purchase order are controlled: they carry a hold or release status and have their own report listing who received what, from whom and at what cost. Expect them to be reviewed.
Ask Tansi Intelligence
The third tab answers plain-language questions about your inventory, using the same AI analyst as the Intelligence pages. It appears when AI is enabled for your Tansi site and your role includes the Intelligence module and its AI feature. Type a question (e.g. Which items were requested most in the last 90 days?) or pick a suggested one, such as Which lots expire in the next 60 days? or Purchase spend by vendor this year. Answers are built from the inventory datasets below, run with your own permissions, and can be saved as a widget on your Intelligence dashboard.
Under Explore inventory data, cards for the stock, transactions and requests datasets open in the pivot builder (Open in pivot builder), which needs the Intelligence Builder feature. Links lead to the Intelligence dashboard and Operations reports. If AI is off, or your role lacks the module or feature, the tab says which, and the datasets may still be usable.
Use case: month-end pack (office and warehouse)
- On the last day of the month, open Documents.
- Download the Transaction Report (PDF) for the month for each warehouse.
- Download Warehouse Receipts Without a Purchase Order (PDF) for the same dates and send it to finance.
- Set the Nearing Expiry Report to 2 Months, download the Excel, and press Open on lots board to act on it.
- Next month, scan the report ID barcode on last month's printout to re-run it with the same settings.
Requests Admin at a glance
Requests Admin is where an administrator decides how requests are approved, routed, named and printed. Its page reads Configure workflows, routing, delegations, and forms for purchase, transfer, and supply requests. Most people never open it, but it explains why a request went to the person it did.
To get there, use the Settings card on the Requests hub, or the Admin hub button found on every admin page. The side menu has Admin › Request Settings under Assets & Inventory (and under Maintenance › Inventory), which opens Request Settings directly.
You only see the tiles you can use
Each tile appears only when you hold the permission its page needs. If you hold none, the hub says You don't have permission to access this page. If Tansi cannot work out your permissions, it shows no tiles rather than all of them.
| Tile | What it is for | Permission that opens it |
|---|---|---|
| Approval Workflows | The step-by-step routes a request follows. | Approval workflows |
| Route map | Every kind of request and the route it takes, in one chart. | Routing rules |
| Routing Rules | The ranked list of rules choosing a workflow. | Routing rules |
| DOFA Thresholds | Amount tiers for goods and services. | Approval workflows |
| DOFA Authorities | Imported table of who may approve invoices, per cost center. | Approval workflows |
| Delegations | One person covering another's approvals for a while. | Delegations |
| Designated Approvers | Each user's go-to approver. | Approval workflows |
| Creation Forms | Forms to complete before a request is submitted. | Creation forms |
| Form Definitions | The form templates (not built yet, see later). | Creation forms |
| Request Templates | Reusable starting points for new requests. | Manage templates |
| Request Settings | Names, page names, reminders, ordering rules, purchasing, invoices, finance codes, auto-save. | Approval workflows |
| Branding | The logo printed on documents. | Approval workflows |
| Request Permissions | Who may create and approve requests. | Roles (Admin) |
Request Settings and Branding also need edit rights on that permission, not only view. Without them they read You don't have permission to change request settings. and You don't have permission to change tenant branding.
Every admin page and its address
| Page | Address | What it is for |
|---|---|---|
| Requests Admin | /requests/admin | The tile hub. |
| Approval Workflows | /requests/admin/workflows | List of workflows, coverage per type. |
| New / edit workflow | /requests/admin/workflows/new | The workflow builder. |
| Route map | /requests/admin/route-map | Rows in checking order, with their routes. |
| Routing Rules | /requests/admin/routing-rules | Read-only ranked list of rules. |
| DOFA Thresholds | /requests/admin/dofa | Amount tiers and the workflow each uses. |
| DOFA Authorities | /requests/admin/dofa-authorities | Imported invoice approval authority. |
| Approval Delegations | /requests/admin/delegations | Cover for absent approvers. |
| Designated Approvers | /requests/admin/designated-approvers | Go-to approver per user. |
| Creation Forms | /requests/admin/creation-forms | Forms required before submit. |
| Form Definitions | /requests/admin/form-definitions | Placeholder page. |
| Request Settings | /requests/admin/settings | Workspace-wide request settings. |
| Branding | /requests/admin/branding | Document logo. |
| Warehouse Queue | /warehouse/dashboard | Pick, pack and ship work, incoming orders. |
| Work order | /warehouse/work/… | One request being picked, packed and shipped. |
The old address /requests/admin/naming still opens Request Settings. The earlier "Naming & Labels" page is now its Names section.
Approval workflows: the list
An approval workflow is the route a request follows after it is submitted: who approves it, in what order, whether it forks, whether the warehouse picks and ships it, and how it ends. Approval Workflows lists them: Ordered step sequences that approve purchase, transfer, and supply requests.
Header buttons: Admin hub, Route map and New Workflow.
Per-type coverage
One tile per request type, Supply, Purchase, Transfer and Return, counting the active workflows that apply to it. A workflow that applies to all types counts on every tile. A tile at 0 is worth a look. Clicking a tile starts a new workflow already set to that type and named, for example, Supply approval.
Filters and columns
Scope shows All, My tenant (your workspace's own) or Global (platform-wide, supplied by Tansi). Request type narrows to one type. With nothing to show the list reads No workflows match the current filter.
| Column | What it tells you |
|---|---|
| Name | With its description and a step count, plus includes forks when the route splits somewhere. |
| Scope | Tenant (yours) or Global. |
| Applies to | The request types it is for, or All types. |
| Steps | How many steps it has. |
| Active | Yes or No. Only active workflows route requests. |
The export menu downloads the rows you see.
Row actions
| Icon | What it does |
|---|---|
| Edit | Opens the workflow builder. Shown for your workspace's own workflows. |
| Clone to my tenant | On global workflows. Copies the whole route into your workspace as name (Copy), switched off and not the default, and opens it. Tansi says Workflow cloned as a draft — review it and turn it on. |
| Delete | Asks Delete Workflow? and warns This action cannot be undone. |
Cloning a global workflow and adjusting it is usually quicker than building from scratch, and the clone cannot route anything until you turn it on.
Building a workflow: the editor
New Workflow or a row's edit icon opens the builder: Everything the request goes through, written out and drawn. Everything is on one screen.
A new workflow starts small
A brand-new workflow already tells a complete story: step 1, Approval, goes to the requester's designated approver, any one approval is enough, it is chased after 2 days, and it can be sent back; step 2, Done, ends the request as Approved. It starts switched off.
Save, Turn it on, Turn it off
| Button | What it does |
|---|---|
| Save | Stores the workflow as it is. Grayed out until it has a name. A new workflow gets its own address after the first save. |
| Turn it on | Saves and switches it on, so routing can use it. Grayed out, with the tooltip Fix the problems listed below first, while any serious problem is listed. |
| Turn it off | Saves and switches it off. Shown instead of Turn it on when it is on. |
There is no "active" switch anywhere else. These buttons are the only way to change it.
Adding, editing and deleting steps changes the screen only. Nothing is stored until you press Save (or Turn it on / Turn it off). Routing rules on this page are the exception: they save the moment you save the rule.
If a workflow is on and your edits leave a serious problem, Save is refused with This workflow is on and can't be saved with these problems — fix them, or turn it off first.
The problems bar
Above everything, Tansi lists what is wrong. Serious problems come first, in red; they block Turn it on. Warnings follow in amber. Each has a title and a line saying why it matters. Click one to jump to the step concerned. Tansi also checks live data: a role with nobody in it, or a named approver who is no longer active in your workspace.
What this workflow is, and which requests reach it
This panel shows the name, description, Applies to: (types, or any request type) and chips such as Default fallback when no rule matches and Produces: the resulting document. Edit these opens What this workflow is:
| Field | What it means |
|---|---|
| Name | Required, up to 200 characters. |
| Description | Up to 1,000 characters. |
| Applies to request types | Pick one or more; Leave empty for all types. |
| Resulting document | The document the request produces: PurchaseOrder, Contract or APDirectPayment. |
| Use as default workflow when no routing rule matches | The catch-all route. |
Changing the types or the document also changes who can be picked as a named approver: only people allowed to approve that kind of request are offered.
Under it, Which requests reach it lists this workflow's routing rules with Add rule, edit and delete. Before the first save it reads Save the workflow first, then decide which requests reach it here. With no rules: No routing rules yet — this workflow is only reached when it is the tenant's default. See Which requests reach a workflow.
The steps, written out, and the diagram
The left half, The steps, written out, lists every step in order with its number, name, kind and a plain sentence of what it does. The right half, The diagram, draws a box per step. A line joins two boxes only when one really leads to the next, so a gap is a real gap. Fork paths show as small buttons such as Yes → step 3, or → nowhere.
- Press a step (in either half) to open its detail panel on the right.
- The pencil on a written step opens the step editor straight away.
- Add a step opens the step editor for a new step. It is inserted before the final End step, and whatever led to the End now leads to the new step.
The step detail panel
The panel reads Step 2 of 4, lists anything to fix on this step, says in a sentence what the step does, and then lists its settings: who, how the decision is made, time allowed, how people are told, delegations, what comes Next and what it is Reached from (It is the first step, or Nothing reaches it when it is cut off).
Edit this step opens the editor. Delete this step asks you to type DELETE, because deleting also clears every arrow pointing at it. Close or Esc closes the panel.
Older workflows that ran approvals all at once or until the first approval show a yellow banner. Saving in the builder turns them into a chain that runs step by step, in order. Check the steps before you save.
Step kinds and who a step lands on
The step editor opens as Add a step or Edit followed by the step name. It always starts with What this step is called and What kind of step. The questions below change to match the kind. Cancel discards your changes; Save this step puts them on screen (then save the workflow).
The eight kinds
| Kind | What it does |
|---|---|
| Approval | One or more people approve or reject it. |
| Fill in a form | Somebody completes a form before the request moves on. |
| A fork in the road | Send it down different paths depending on the request. |
| Pick it in the warehouse | Warehouse staff pick the items against the request. |
| Pack and ship | Pack, label and hand it to the carrier. |
| Receive it | The requester confirms what turned up. |
| Tell somebody | A message goes out. Nothing waits for it. |
| The end | The request stops here, with an outcome. |
Who it lands on
The question is worded Who it lands on, Who it is told (Tell somebody) or Who fills it in (forms).
| Choice | Who that is | Offered for |
|---|---|---|
| A named person | One person you search for (type 2 letters or more). If they may not approve this kind of request an Ineligible chip appears, with a button to grant the permission. | All except Pick |
| Anyone in a role | Everybody holding the role you pick under Which role. For approvals and messages, Where limits it to people assigned at the request's location or above it, or at one named location. | Approval, Tell somebody, Pack, Receive |
| The requester's designated approver | Read from the requester's profile when the request runs. Set it in Designated Approvers. | Approval, Tell somebody, Form |
| The requester's manager | Read from the requester's profile when the request runs. | Approval, Tell somebody, Form |
| The warehouse team for the location | The team assigned to the warehouse chosen in Which warehouse. | Approval, Tell somebody, Pick, Pack, Receive |
| The requester | Whoever submitted the request. | Tell somebody, Form, Receive |
An approval can never go to the requester: nobody approves their own request. A form goes to one person, never a group. A pick always goes to a warehouse team. For pick and pack the default warehouse is The warehouse it ships from; for other kinds it is The request's own location.
If you pick a named location under Where, only people with the role assigned at that location are asked. If none of them can open the request, nobody is asked.
Approval settings
| Setting | What it means |
|---|---|
| How the decision is made | Any one of them approves, All of them must approve, or A set number of them with How many of them (starts at 2). |
| Days before it is chased | After this many days the approvers are reminded. Leave empty and nobody is chased. |
| Honour delegations | If the approver has someone covering them, the stand-in can approve. |
| They can send it back | Returned to the requester to fix, rather than rejected outright. |
How they are told
For every kind except forms, forks and endings, tick any of In the app (the copy that stays), Email (detail and a link) and Text message (fastest, costs money per message, one line and a link; reaches only people who turned texts on). Leave Respect what each person has switched off ticked unless the step is genuinely urgent.
Settings for the other kinds
- Tell somebody: What it says, with a character count. Keep it to one line if a text is ticked. The request moves straight on.
- Fill in a form: Which form (dynamic forms only for now), It has to be filled in (the request waits until the form is submitted) and How many days they have to fill it in. Tansi checks for finished forms every 15 minutes, so a wait of a few minutes after submitting is normal.
- Pick it in the warehouse: Part shipments allowed, meaning the warehouse can ship what it has and send the rest later. Off means everything ships together.
- Pick, Pack and Receive: Days before they are chased.
- The end: Outcome, stamped on the request, for example Fulfilled.
Forks
What it splits on: How much it costs, Whether it has a restricted item, Item type (Goods or Services), Request type or Location. Changing it clears each path's value. A new fork starts with paths Yes and No.
Under The paths out of it, each path has a label, a value (such as Up to $5,000) and goes to a step. Move paths up and down, remove them, or Add another path. Paths are tried top to bottom and the first that fits wins; leave a value empty for "anything else", and put that path last.
Linking steps
Every kind except forks and endings asks When this step is done, go to: a later step, or Nothing — stop here.
Which requests reach a workflow: routing rules and the Route map
Many workflows can exist. A routing rule says "requests like this go to that workflow". When a request is submitted, Tansi checks the active rules from the highest priority down; the first rule that fits decides. If none fits, the request goes to the workflow marked as the default.
The rule dialog
The same dialog is used from the workflow builder (Add rule) and from the Route map. Every condition you fill must be true for the rule to fit; an empty one matches anything.
| Field | What it matches |
|---|---|
| Priority (higher wins) | Its place in the checking order. |
| Active | Only active rules are checked. |
| Match request type | One type, or empty for any. |
| Match location | Requests for one location. |
| Supplied by | Requests from places this warehouse supplies: inside it, or ordering from it through a sharing rule. |
| Min estimated value / Max estimated value | A value band. |
| Restricted items | Restricted only, Exclude restricted or Ignore (any). |
| Returns | Returns only, Exclude returns or Ignore (any). |
| Not-allowed item overrides | Requests where a line was added against a location's not-allowed list with a documented override: Overrides only, Exclude overrides or Ignore (any). Route these to whoever signs off on exceptions. |
Some rules carry conditions set elsewhere (a category, an item type, a requester role). They show as gray chips with Advanced conditions set elsewhere — preserved on save, not editable here.
The Routing Rules page
Routing Rules is now a read-only ranked list: Rules are ranked — the first match decides the workflow. Edit a rule inside its workflow. Columns: Priority, Scope, Workflow (a link to its builder when you may edit it), Conditions (chips such as Type = Supply, Min $ 5000, Returns only, or Matches all) and Active. With no rules it explains that requests fall back to the default workflow.
The Route map
Route map draws the same rules as rows: Where each kind of request goes, in the order Tansi checks: the first row that fits a request decides its route. Each numbered row names the kind (Supply request, Purchase order, Any request…) and its conditions in words, for example worth $5,000 or more, for North Warehouse. Under it, the route's steps are drawn as boxes with arrows, each saying who acts, such as any one: Supervisor at the request's location. Clicking a box or + step opens the workflow builder.
| Control | What it does |
|---|---|
| Goes to | Switch the row to another active workflow. Saved at once. |
| Up / down arrows | Check this row earlier or later (swaps it with its neighbor). |
| Tune icon | Change which requests this row covers (opens the rule dialog). |
| Red power icon | Switch the row off. It moves to Switched off, where Switch on brings it back. |
Rows you cannot change show a lock with Shared across workspaces or Another workspace's row. The last row, Anything else, is the default route. If there is no default it says No default route: such a request can't be submitted.
Add a kind of request: choose where it Goes to, press Choose which requests…, and fill in the rule. Build a new route opens a new workflow. Every change on the Route map is written to the audit log.
New rows, from the Route map or from Add rule, get a priority above every existing row, so they are checked first. A broad new row (say, every supply request) will capture requests that used to reach narrower rows below it. Move it down if needed.
When a row says Also used by 2 other rows: changing its steps changes theirs, editing that workflow changes the route for all three. Clone it first if only one row should change.
The Route map calls the restricted-items condition with a controlled substance. It is the same condition as Restricted items in the dialog. It may also show steps Tansi adds on its own, such as controlled-substance approvers or the items' approvers (set under Access Center › Approvers), and the DOFA authority.
Some wording on these screens comes from health-care customers (medication, controlled substances, cold chain). The features themselves work the same for any stock: tools, parts, office supplies, event kit or building materials.
DOFA thresholds and DOFA authorities
DOFA stands for Delegation of Financial Authority: the rules saying who may approve how much. Tansi has two pages for it.
DOFA Thresholds
This page is a table of amount tiers. Changes apply to new requests immediately. A banner explains the rule: when a request is created, the first active row whose Min ≤ Amount < Max and whose item type matches is applied. Use Both for rows covering goods and services. Leave Max blank for the unlimited (∞) tier.
| Column | What to enter |
|---|---|
| # | The row's place. Rows are checked top to bottom. |
| Min Amount / Max Amount | The band. Max blank means unlimited. |
| Item Type | Both, Goods or Services. |
| Approval Workflow | Required. Start typing to pick an active workflow by name. |
| Required Documents | Free text, for example Quote, PO. |
| Description | A note for other admins. |
| Active | Only active rows are used. |
| Actions | Move up, move down, remove. |
Add Threshold adds a row at the bottom (Min 0, Max unlimited, Both, active). Removing a row asks Remove Threshold? and reminds you the removal is only permanent after you save. All amounts are in Canadian dollars.
Nothing on this page is stored until Save All Changes (top or bottom). Discard changes reloads the saved table. Saving checks every row: Approval Workflow is required, Min Amount cannot be negative, and Max Amount must be greater than Min Amount, each with the row number.
Open Test a sample amount against this DOFA table, enter a Sample amount (CAD) and Item type, and press Match. Tansi names the workflow, the required documents and the band, or says No active threshold matches that amount/type combination.
Match tests the saved table, not the edits on screen. Save first, then test.
Each row stores the workflow's name as text. If someone renames a workflow, check the rows that used the old name.
DOFA Authorities
This page is read-only: Who may approve vendor invoices, per cost centre and up to what amount — imported from your finance system. Rows are loaded with Import DOFA file, which opens Data Import. Your finance system's file is the source of truth.
The box at the top says what the table is doing right now:
- With no active rows, invoices are verified as before, by anyone allowed to fulfill purchase orders.
- With active rows loaded, a vendor invoice can only be approved by someone holding an active authority for the purchase order's cost center (or all cost centers), with a limit at least the invoice total, on the approval date. Delegations count for the delegate. One qualifying approver is enough.
It also names the DOFA process used for Tansi invoices, set in Operations reports on the Finance Export tab.
Filter by Cost centre or Approver (ID, name or email), and switch on Show inactive rows to see old ones. Columns: Cost centre (or All cost centres), Approver (finance ID, name and email; no Tansi user yet when the email matches no user; No email — can't be linked to a user), Level, Limit, Effective (Always, From…, Until…), Delegation (Acting for…), Process and Status (Active, Inactive, Expired, Not yet in effect). The footer shows when it was last imported.
The first import with active rows changes who can approve invoices at once. Approvers whose email does not match a Tansi user cannot approve until they have an account with that email.
Delegations and designated approvers
Two pages keep approvals moving when people change roles or go away.
Designated Approvers
Set each user's go-to approver. Workflow steps with the "Requester's designated approver" resolver route automatically to the approver picked here. The page lists every active user in your workspace. Search by name or email… narrows the list.
| Column | What it is for |
|---|---|
| Expand arrow | Opens the user's alternate approvers (below). |
| User | The requester. A chip such as 2 alts counts their alternates. |
| To tell people with the same name apart. | |
| Designated approver | Pick from every other active user, or — None —. |
| Save / check | A row Save button appears when you change it; a green check means saved. |
Save all (with a count) saves every changed row at once, and reports how many saved and how many failed.
People with a rule stopping them from approving are marked in the list: fully denied (cannot be picked) or cannot approve followed by the types. If you pick someone who cannot approve some types, a warning says workflows for those types will fail.
Alternate approvers (per request type) override the default approver for one type, which is useful when the default cannot approve that type. One alternate per type. Press Add alternate, choose the Request type (only types without an alternate are listed), then the Alternate approver (only people eligible to approve that type are offered), and Save. The trash icon removes an alternate straight away, without asking.
If you changed a user's designated approver and then add an alternate, Tansi saves the default first and tells you so.
If nobody is eligible for a type, the dialog says so and points you to Request Permissions to grant approve permission first.
Approval Delegations
Cover one user's approval responsibilities with another user for a date range. Use it for holidays, leave or a busy month.
| Column | What it shows |
|---|---|
| Delegator | The person being covered. |
| Delegate | The person covering. |
| Start / End | The dates. |
| Status | Scheduled (not started), Active, Expired or Revoked. |
| Reason | Why, if given. |
- Press New Delegation (or Create first delegation on an empty page).
- Search for the Delegator (who is being covered) and the Delegate (who will cover). They must be different people.
- Set Start date and End date. They start as today and two weeks from today. The end cannot be before the start.
- Add a Reason (optional) and press Create.
A delegation cannot be edited. To change one, revoke it and create a new one. The revoke icon is only on rows that are Active right now; Tansi asks Revoke Delegation? first.
The stand-in can approve only on workflow steps with Honour delegations ticked. Delegations also count for invoice approval under DOFA Authorities.
When requests sit unapproved, the usual causes are a requester with no designated approver, an approver with a deny rule, or an approver who is away with no delegation. All three are quicker to fix here than by chasing requests one by one.
Creation forms, form definitions and branding
Creation Forms
Forms that must be completed before a request can be submitted for approval. With none set up, the page says requests may be submitted without any gating form. Filter by Request type.
| Column | What it shows |
|---|---|
| Name | With its description. |
| Request type | The type it applies to. |
| Form definition | The form people fill in. |
| Scope | Tenant (yours, editable) or Global (read-only). |
| Required | Required or Optional. |
| Order | The order forms are presented in. |
New Creation Form opens a dialog: Name (required, up to 200 characters), Description, Request type, Form definition (required), Sort order and Required before submit (ticked by default). Save stays grayed out until there is a name and a form. Delete asks first and cannot be undone.
Form Definitions
This page is a placeholder today. It says Form definitions admin coming in a future release. and that creation forms currently pick from form definitions already loaded into Tansi. It has one button, Manage Creation Forms. You cannot design a form here; ask Tansi support if you need a new form definition.
Branding
The logo printed on this tenant's purchase orders, packing slips, receiving reports and request printouts. Documents print your workspace's name next to the logo. Document titles follow the names in Request Settings.
- Drag an image onto Upload a logo, or click browse. JPG, PNG, GIF or WebP, up to 5 MB.
- Tansi resizes it so its longest side is at most 600 pixels and converts it to PNG. The preview shows New logo with a Not saved chip, on white, as it will print.
- Press Save logo. Logo saved. New documents will print it. Or press Discard.
With no logo, the preview says documents show the tenant name only. Wrong file types, files over 5 MB and unreadable images are refused with a message.
Remove logo takes the logo off immediately, with no confirmation. Keep a copy of the file if you might want it back.
Request Settings: names, page names, reminders and ordering rules
Request Settings holds the workspace-wide choices for requests: How requests are named, what they remind people of, what one request may hold, and how purchase orders are handled. Open it from the hub tile or Admin › Request Settings.
Getting around
A list on the left (a row of buttons on a phone) shows one section at a time. Each entry has a one-line summary of its current setting and a dot when it has unsaved changes. A link at the bottom, Logo on documents, opens Branding. The address keeps the section, so a link or refresh opens the same one.
You can move between sections freely: edits are kept until you save. The bar at the bottom reads Not saved yet: with the section names, or All changes saved. Save changes saves; Discard puts everything back. Only the sections you changed are written, so you will not undo another admin's change to a different section. Leaving the page with unsaved changes asks Leave without saving? with Leave without saving or Stay.
Names
What requests are called on screens, emails and printed documents. Fill in Singular and Plural for Any request (the general word, as in "My Requests") and for each type. Each box takes up to 80 characters; leave it blank for the Tansi name. Use Tansi names clears them all.
Renaming "Supply Request" to "Stock Order" does not change the number: it still starts SR-. Routes and approval workflows do not change either.
Page names
What these pages are called in the menu, on the page itself and on the buttons that open it. Each renameable page has a Shown as box, for example Withdraw Supplies or Withdraw for Delivery. Who can open them and what they record stay the same. After saving, Tansi notes that the menu shows the new names the next time a page is loaded. Use Tansi names puts the defaults back.
A school might call Withdraw Supplies "Classroom Sign-out"; a construction firm, "Tool Crib Issue". The page works the same way.
Reminders
A pop-up shown before someone submits a request, and to the approver before they approve it. Each request type is a row showing Submit: On/Off and Approve: On/Off. Open it and write Before submitting and/or Before approving; a counter shows the length. Leave a message blank for no pop-up.
Ordering rules
What one request may hold. "Category" here means a top-level category in your item catalog.
- For types that can be split, a row reads, for example, Supply Requests that mix categories, with three choices: Allow them as one request; Split them into one request per category (the requester orders everything on one request, and on submit each category becomes its own request, approved and filled on its own); or Refuse them: the requester raises one request per category.
- For other types, One category per request has a switch per type. On, a request that mixes categories cannot be submitted.
- Either way, an uploaded file is split into one request per category.
The screen's example is Medication and Medical Supply. The rule works the same for, say, Electrical and Plumbing, or Stationery and Furniture: anything that should be approved or filled separately.
Request Settings: purchasing, invoices, finance codes and auto-save
Purchasing
Purchase order fields and where purchase orders are sent.
| Setting | What it does |
|---|---|
| Finance system PO number | What your finance system's PO number is called, for example PeopleSoft PO, SAP PO or Oracle PO. Up to 80 characters. |
| Receiving without a PO, Put it straight on hand | On: stock received without a PO number (Exceptional receipts or the inventory app) is usable straight away, though the receipt still waits on Exceptional receipts until someone adds the number. Off: it is held as reserved and cannot be used until the number is added. Receipts already held stay held. |
| Returns from stations, Returned stock goes on hold | On: stock a station sends back is held where it is received and waits on Returns on hold until someone restocks it, disposes of it or sends it to the vendor. Off: it is usable as soon as it is received. |
| Contract field | What the contract box on a purchase order is called, for example Contract ID / Master agreement. The list of contracts is kept on the Contracts page. |
| Ask for a contract | When Tansi asks: when a purchase order is created from a supply request and again at submit (blank allowed); the same, but submit is blocked until a contract or N/A is chosen; or never (the field is there but nothing asks). |
| Accounts payable mailbox | An Email address and optional Name. Purchase orders get an Email AP button that sends the document there. Leave it blank to hide the button. An invalid address stops the save with The accounts payable email address isn't valid. |
Invoices & matching
How vendor invoices are checked against the purchase order and what was received before they are paid, and what happens to each difference. The master switch is Match vendor invoices to purchase orders. Off, an invoice is attached and Approve for payment pays what was received at PO prices; most other settings are then grayed out with a note saying so. On, Enter invoice opens a matching screen that compares every line, extra cost and tax and asks what to do about each difference.
- What an invoice is compared with: two-way (the PO), three-way (the PO and what was received) or four-way (also inspection; works as three-way for now).
- Attaching an invoice: require the scan, refuse an invoice number already used on the PO family, open matching right after attaching.
- Price tolerance, Other tolerances (tax rounding, quantity), and what happens by default when the invoice price is lower or higher than the PO, including supplemental POs, PO revisions, accepted variances (Finance only, inside the limit), paying the PO price only, and holds.
- Items not received and split POs: what to do when billed fewer or more than received, and how split POs are numbered (letters or numbers, up to 26 per PO).
- Extra costs and taxes, Controls and audit (for example, someone who received items can't approve the invoice), Accounting and payment and Notifications.
A few switches are marked (not used yet) or (not sent yet): they are stored but do nothing today. Two are always on and cannot be changed: the audit trail of every change, and no payment until supplemental POs and revisions are approved. Invoice matching itself is explained with purchase orders.
Finance codes
The finance codes a purchase order takes when nobody codes it by hand. Each code comes from the most specific place that names it; these are the last resort. If your workspace has no finance codes yet, the section tells you to import them under Data Import › Financial Codes first.
- Last-resort codes: Account, Cost centre, Program (every purchase order takes it), Finance location and Project (every purchase order takes it).
- Extra costs: the account each kind of extra cost goes to in the payment file. Blank keeps the order's own account.
- Set elsewhere lists the more specific places: locations, categories, vendors, an item's supplier rows, departments on Workspace lists and carriers. A purchase order takes its codes as it is approved, and only where nobody coded it by hand.
Auto-save
Work in progress saves itself as a draft, so nobody loses it when they are signed out. Turn on Save automatically and choose How often. It covers a request being written, an exceptional receipt and a withdrawal for delivery. Each keeps a single draft that is updated, never copied. A request is saved only once something has been entered, and only while it is still a draft.
Use cases: setting up approvals step by step
1. Office: every supply request approved by the requester's manager
- On Approval Workflows, click the Supply coverage tile. A starter workflow opens, named Supply approval.
- Press step 1, then Edit this step. Set Who it lands on to The requester's manager, keep Any one of them approves, tick Email as well as In the app, and Save this step.
- Press Edit these and tick Use as default workflow when no routing rule matches. Save the dialog.
- Check the problems bar is clear, then press Turn it on.
- On Route map, the Anything else row now reads Goes to the default route Supply approval.
2. Construction: purchases over $10,000 need a director as well
- Open the purchase workflow. Press Add a step and create an Approval step called Director sign-off: Anyone in a role, role Director, Where At the request's location. Save the step.
- Press Add a step again and create A fork in the road called Over $10,000?, What it splits on How much it costs. Save the step.
- Now set the links, because each new step is slotted in right before the end. Edit the first approval: When this step is done, go to the fork.
- Edit the fork. Path 1: label Small, Up to $10,000, goes to the End step. Path 2: label Large, value empty (anything else), goes to Director sign-off.
- Edit Director sign-off: When this step is done, go to the End step.
- Press each step and read Reached from and Next in its panel to check the chain. Fix anything in red on the problems bar, then Save.
3. Warehouse: approve, pick, ship, receive
- Click the Transfer coverage tile on Approval Workflows to start a transfer workflow (or clone a global one with Clone to my tenant).
- Press Add a step: Pick it in the warehouse (warehouse: The warehouse it ships from). Tick Part shipments allowed if partial loads are acceptable.
- Add Pack and ship (the warehouse team), then Receive it (the requester), each with Days before they are chased set to 2. Each new step is slotted in before the end, after the one before it.
- Edit the final step and set its Outcome to Fulfilled. Save, then Turn it on.
- On Route map, Add a kind of request: Goes to the new workflow, Choose which requests…, Match request type Transfer, Supplied by your main warehouse. Move the row below any narrower transfer rows if needed.
4. Health care: the pharmacy lead is away for two weeks
- On Approval Delegations, press New Delegation. Delegator: the pharmacy lead. Delegate: the deputy. Dates: the two weeks. Reason: Annual leave. Create.
- Check that the approval steps the lead handles have Honour delegations ticked.
- On Designated Approvers, check the deputy's name in the approver list. If it shows cannot approve for a type, add a per-type alternate on the rows of the people the lead normally approves for, so those requests go to someone who can.
- When the lead is back, the delegation shows Expired by itself; nothing needs undoing.
Some wording on these screens comes from health-care customers (medication, controlled substances, cold chain). The features themselves work the same for any stock: tools, parts, office supplies, event kit or building materials.
Pickers, labels and warnings you meet everywhere
A handful of controls appear on many pages in this module: receiving, moving, requesting, reporting. They behave the same everywhere, so learning them once pays off.
The location picker
Wherever you choose a location, Tansi shows a tree rather than a long list. The closed field shows the full path; hover to see it when it is cut off.
- Click the field (or press Enter, Space or the down arrow) to open it. Sites start collapsed, except along the path to the current choice. A number beside a closed site counts what is inside it.
- Type in Filter locations… to narrow the tree. Matches stay under the sites that lead to them, so you can tell two rooms with the same name apart.
- Use the arrow keys to move, right and left to open and close a branch, Enter to choose and Escape to close.
- A Partner site tag means You can send to and request from here, but its stock is not visible to you.
- Where stock must go somewhere real, grouping levels are grayed out: A grouping level — nothing is stored here. Pick a site inside it.
- The ✕ clears the choice. Some reports allow several locations: rows get tick boxes, the field shows chips (or N locations), with Clear all and Done, and Includes everything under the chosen locations.
Put away into (storage spot)
When you receive into a location that has storage spots, Tansi asks where the stock should physically go:
- One possible spot: Auto-selected … and nothing to do.
- The item is already stored there: Already stored in N places here — put it away with the existing stock, or choose a different spot. The spots holding it are offered first, with their quantities, so stock stays together.
- The item is new there: This item isn't stored anywhere in this location yet — choose where to put it.
- A different location… opens Choose the location for spots holding none of this item.
If the location has no storage spots, nothing is shown and the stock goes to the location itself.
Storage area
Some dialogs have a free-text Storage area box (Shelf, bin, cabinet…). It suggests areas already used at that location and still accepts a new name. Typing cabinet 2 snaps to an existing Cabinet 2, so you do not end up with two spellings.
Department and funding source
Department picks from your workspace's departments. Where allowed, typing a new name offers Add … as a new department, after a confirmation, because a department added by mistake shows up in every picker. Funding source picks where the money came from, shown with its code.
Which product?
If you pick a generic item by hand and more than one of its specific products could serve, Tansi asks Which product?: … is a generic item. Choose the product you are going to issue — it decides the unit, price and taxes recorded. Each option shows its picture, brand, SKU, unit, barcode, supplier, price (if you may see costs), a Preferred tag and how many are here. Out-of-stock options are dimmed. Pick one and press Use this product, or double-click it. A scan never asks, because the barcode already names the product, and a single stocked product is used without asking.
Item labels
| Label | Meaning |
|---|---|
| Critical | Critical item — keep it in stock and report shortages right away. |
| Controlled | Controlled item — extra approval or handling rules apply. The tooltip shows the reason when one is set. |
| Storage type, such as Refrigerated | Store as: … |
| High risk | High-risk item — handle with care and follow its safety sheet. |
| Hazardous | A hazardous item (shown in pickers). |
| SDS | A Safety Data Sheet applies to this item. |
| Safe handling | A safe-handling procedure applies; the tooltip names it. |
| 6 h once open (for example) | Use within 6 hours of opening. |
| Credit return | The vendor takes this back for credit. Send it back instead of throwing it away. |
On long lists, such as request lines, the same labels appear as one compact line; hover for the full wording.
Warning dialogs
| Dialog | When it appears | What to do |
|---|---|---|
| Inventory warning | You scan or handle an item that is restricted, high risk or has receiving requirements (for example Receiving requires: lot number, expiry date.). | Read it and press Acknowledge, or Cancel. |
| Inventory warnings | Several items on one receipt have warnings. Items with the same warnings are grouped. | Press Acknowledge all (N), or Cancel. |
| Lot status warning | A lot involved is quarantined, suspended or recalled. Shows the reason and quantity. | Press Acknowledge to go on, or Cancel. It cannot be dismissed by clicking outside it. |
Every acknowledgement is recorded in the audit log with what you were doing, so a later review can see who went ahead with a held lot or a controlled item.
Every page in this module
Pages marked From … are not in the menu; you reach them from the page named. Your role decides which of these you can open. Page and request names may differ in your workspace if your administrator renamed them.
| Page | Address | Where in the menu | What it is for |
|---|---|---|---|
| Hub | /requests | Always shown | The Requests hub: counters, shortcuts and your work queues. |
| Withdraw Supplies | /inventory/withdraw | Always shown | Record supplies taken, dispense multi-use units and see waste. Often renamed, for example Dispense. |
| Move Stock | /inventory/move-stock | Always shown | Move stock between storage spots inside one location, immediately. |
| Receive Deliveries | /admin/inventory/inbound | Always shown | Deliveries coming to your location (same page as Inbound Deliveries). |
| Item Master | /admin/inventory/items | Stock | Your product and asset catalog. |
| Item page | /admin/inventory/items/{id} | From the Item Master | One item: stock, history, lots, documents and safety. |
| New item / Edit item | /admin/inventory/items/create, /admin/inventory/items/edit/{id} | From the Item Master | Create or change an item. |
| Stock Levels | /admin/inventory/stock | Stock | On hand, reserved and available across every location; assets. |
| Lots | /inventory/lots | Stock | Every lot, with expiry, quarantine, suspension and recalls. |
| Lot page | /inventory/lots/{id} | From Lots | One lot: where it sits, its history, and status changes. |
| Reserved Stock | /admin/inventory/reserved | Stock | What is held, and what holds it. |
| Returns on hold | /admin/inventory/returns-on-hold | Stock | Station returns waiting for a decision. |
| Stock Review | /admin/inventory/review | Stock | Flags raised from the Tansi Inventory app. |
| Critical Items | /admin/inventory/critical | Stock | Must-never-run-out and restricted items. |
| Waste Management | /admin/inventory/waste | Stock | Record and review waste; disposal audit. |
| Reorder Suggestions | /admin/inventory/reorder | Stock | Items at or below reorder per location; turn them into orders. |
| Order Schedule | /admin/inventory/order-schedule | Stock | Which facilities are due to order, by calendar. |
| Inventory Count | /admin/inventory/count | Stock | Count stock, review differences and apply adjustments. |
| Exceptional receipts | /admin/inventory/receive-without-po | From the Hub and Stock Levels | Deliveries without a Tansi order, and their hold or release. |
| New receipt without a purchase order | /admin/inventory/receive-without-po/new | From Scan & Receive and Exceptional receipts | Record a delivery with no Tansi order behind it. |
| Scan & Receive | /admin/inventory/barcode-scan | Warehouse | Scan a barcode to look up an item or open a request. |
| Inbound Deliveries | /admin/inventory/inbound | Warehouse | Approved purchases and transfers awaiting receipt. |
| Withdraw for Delivery | /inventory/withdraw-delivery | Warehouse | Ship stock to departments or places with nobody on Tansi to receive it. |
| Transaction History | /admin/inventory/stock/history | Warehouse | The stock ledger: every movement in and out. |
| Warehouse Queue | /warehouse/dashboard | From the Hub | Pick, pack and ship request work. |
| Warehouse work order | /warehouse/work/{id} | From the Warehouse Queue | Work one request: pick, pack and ship. |
| Manage Feedback | /admin/inventory/order-surveys | Surveys | Order feedback surveys you send to sites. |
| New / edit feedback survey | /admin/inventory/order-surveys/new, /admin/inventory/order-surveys/{id}/edit | From Manage Feedback | Set up a survey's dates, items and responders. |
| Feedback survey page | /admin/inventory/order-surveys/{id} | From Manage Feedback | Send, follow, close and turn a survey into vendor drafts. |
| My Order Feedback | /inventory/my-surveys | Surveys; also Home › My Work | Surveys sent to you. |
| Enter Order Feedback | /inventory/my-surveys/{id} | From My Order Feedback | Enter and submit your site's quantities. |
| Snapshot History | /admin/inventory/reorder-history | Surveys; also Admin module | Saved snapshots of the reorder list. |
| Inventory Reports | /admin/inventory/reports | Reports | Dashboard, printable documents and Ask Tansi Intelligence. |
| Operations Reports | /reports/operations | Reports | Operations reporting across requests and stock. |
| Audit Log | /admin/inventory/audit-log | Reports | A read-only record of actions taken in the module. |
| New request | /requests/new, /requests/new/wizard | From the Hub | Search for an item and get the right kind of request suggested. |
| New request editor | /requests/new/{type} | From the Hub | A blank supply, purchase, transfer or return draft. |
| Request page | /requests/{id} | From any request list | One request: stage, items, approval, filling, documents and history. |
| Edit draft | /requests/{id}/edit | From a draft request | The editor for a saved draft. |
| Request lists | /requests/list, /requests/list/mine, /requests/list/supply, /requests/list/transfers, /requests/list/purchases, /requests/list/returns | From the Hub | All requests, your own, or one kind. |
| Approval Inbox | /requests/inbox | From the Hub | Everything waiting for your decision. |
| Request Templates | /requests/templates, /requests/templates/new, /requests/templates/{id}/edit | From the Hub | Reusable request templates. |
| Bulk import | /requests/import | From the Hub | Create supply requests from a CSV or Excel file. |
| Return label | /requests/{id}/return-label | From a return request | A printable label for a return to the warehouse. |
| Categories | /admin/inventorycategories | Admin; also Admin module | The category tree items are filed under. |
| New / edit category | /admin/inventorycategories/create, /edit/{id}; /admin/inventorysubcategories/create, /edit/{id} | From Categories | Create or change a category or child category and its fields. |
| Suppliers | /admin/vendors | Admin; also Admin module | Your supplier list. |
| Contracts | /admin/vendors/contracts | Admin; also Admin module | Supplier contracts. |
| Carriers | /admin/inventory/carriers | Admin; also Admin module | Shipping carriers, accounts and service levels. |
| Custom Dropdowns | /admin/customdropdowncategory | Admin; also Admin module | Named lists of values for category fields. |
| Custom dropdown pages | /admin/customdropdowncategory/create, /edit/{id}, /details/{id} | From Custom Dropdowns | Create a list, rename it, and manage its values. |
| Workspace Lists | /admin/inventory/lists | Admin | Workspace-wide lists such as departments. |
| Location Management | /admin/inventory/locations | Admin; also Admin module | The location tree, each location's rules, people and stock. |
| Map Setup | /admin/inventory/locations/{id}/map | From Location Management | A location's map pin, floor plan and pins for what is inside it. |
| Request Settings | /requests/admin/settings, /requests/admin/naming | Admin; also Admin module | Request names, page names, reminders, purchasing and finance settings. |
| Requests Admin | /requests/admin | From the Hub (Settings) | Configure workflows, routing, delegations and forms for purchase, transfer and supply requests. |
| Approval Workflows | /requests/admin/workflows | From Requests Admin | Ordered step sequences that approve purchase, transfer and supply requests. |
| New / edit workflow | /requests/admin/workflows/new, /requests/admin/workflows/{id}/edit | From Approval Workflows | Everything a request goes through, written out and drawn. |
| Route map | /requests/admin/route-map | From Requests Admin | Where each kind of request goes, in the order Tansi checks. |
| Routing Rules | /requests/admin/routing-rules | From Requests Admin | Ranked rules: the first match decides the workflow. |
| DOFA Thresholds | /requests/admin/dofa | From Requests Admin | Approval thresholds under your delegation of financial authority. |
| DOFA Authorities | /requests/admin/dofa-authorities | From Requests Admin | Who may approve vendor invoices, per cost center and up to what amount, imported from your finance system. |
| Approval Delegations | /requests/admin/delegations | From Requests Admin | Cover one person's approvals with another for a date range. |
| Designated Approvers | /requests/admin/designated-approvers | From Requests Admin | Set each person's go-to approver. |
| Creation Forms | /requests/admin/creation-forms | From Requests Admin | Forms that must be completed before a request can be submitted for approval. |
| Form Definitions | /requests/admin/form-definitions | From Requests Admin | Reusable form templates used by creation forms and workflows. |
| Branding | /requests/admin/branding | From Requests Admin | The logo printed on purchase orders, packing slips, receiving reports and request printouts. |
| Request Permissions | /admin/inventory/request-permissions | Admin; also Admin module | Who may create and approve inventory requests. |
| Access Center | /admin/access-center | Admin; also Admin module | Who can see which locations, and sharing between them. |
| Data Import | /admin/inventory/import | Admin; also Admin module | Bring items, stock and more in from a spreadsheet; UPC lookup. |
| Funding Sources | /admin/inventory/funding-sources | Admin; also Admin module | Where the money comes from, for reporting. |
Links in older expiry and recall notifications point to /admin/inventory/lots/{id}; they open the same lot page. /admin/inventory/reorder-suggestions opens Reorder Suggestions, /requests/admin/naming opens Request Settings, and /admin/inventorysubcategories sends you to Categories.
Mass Communication
Messages to many people at once — operational alerts to your workforce, email campaigns to your subscribers, and the lists, templates and logs behind them.
Before you start
Mass Communication is the area of Tansi for reaching many people at once. It sits in the main navigation under the subtitle Bulk messaging, in violet, and its menu has three groups.
| Group | Menu items | What they are for |
|---|---|---|
| Send | Mass Message, Campaigns, Chat | The two senders, plus a shortcut to Chat (marked ALSO, because Chat is its own module). |
| Audience | Lists, Subscribers | The mailing lists campaigns send to, and the people on them. |
| Setup | Campaign Templates, Email Templates, Notification Groups, Message History | Saved designs, the system's own email templates, reusable groups of workers, and the delivery log. |
Two senders that share nothing
The single most important thing to understand about this module is that Mass Message and Campaigns are completely different tools. They do not share a list, a template, a report or an opt-out record.
- Mass Message is for operational messages to your own workforce — a site closure, a safety alert, a shift change. It reaches people in your projects by email, text and in-app notification, all at once.
- Campaigns are for email to subscribers and Tansi users — a newsletter, an announcement, an invitation. They carry an unsubscribe link and your mailing address, honor every opt-out, and report opens and clicks.
A Mass Message email has no unsubscribe link, no mailing address and no opt-out check of any kind. It reaches people who unsubscribed from every campaign. It is built for operational notices to your workforce. Anything promotional or commercial belongs in Campaigns, which is designed around Canada's anti-spam law (CASL).
What you need to get in
The Campaigns, Lists, Subscribers and Campaign Templates pages need two things together: your workspace must include Mass Communication, and your role must give you access to it. When either is missing, each page shows Campaigns aren't available here (or Lists, or Subscribers) and asks you to speak to a workspace administrator.
Mass Message needs a Developer, Admin or SuperAdmin role. Email Templates, Notification Groups and Message History belong to Safety & Compliance and follow its permissions — they are linked here because this is where a communications coordinator looks for them.
The four menu items Campaigns, Lists, Subscribers and Campaign Templates are one permission. You cannot give someone Lists without Campaigns. Mass Message's menu link can appear for a user who has the mass-text permission but no admin role; that user then sees You don't have permission to access this feature. when the page opens. Give Mass Message users an admin-tier role.
Old bookmarks to the retired Mass SMS and Mass Email pages still work: they open Mass Message, which replaced both.
Glossary
| Term | What it means |
|---|---|
| Mass Message | The one-off bulk sender for your workforce. Email, SMS and in-app push, sent in batches. Nothing is saved to come back to except a template. |
| Campaign | One email, its audience, its schedule and its results, stored as a single record you can draft, schedule, resend and report on. |
| Project scope | The projects a Mass Message draws its people and templates from. Required before anything else on the page works. |
| Recipient token | One entry in the Mass Message recipient picker — a person, a notification group, a company, a role, a duty, a location, everyone in scope, or a typed address. |
| Batch | A slice of a Mass Message sent together. Batches go out one after another, with a pause between them. |
| Quiet hours | A Mass Message option that holds the send until 7:00 a.m. local time. |
| Emergency broadcast | A Mass Message shortcut that sets every project, every channel and everyone in the workforce. It fills the form; it does not send. |
| List | A mailing list people subscribe to. Campaigns send to lists; Mass Message does not use them. |
| Subscriber | A person on one of your lists who is not a Tansi user. Underneath, a CRM contact with a list membership. |
| Single opt-in | A public sign-up is subscribed immediately. |
| Double opt-in | A public sign-up is subscribed only after clicking the link in a confirmation email. |
| Pending | A double opt-in sign-up that has not been confirmed yet. Shown as Awaiting confirmation. Never sent to. |
| Suppression | A workspace-wide block on one email address after an unsubscribe from everything, a hard bounce or a spam complaint. |
| Public sign-up form | The page at /subscribe/… where anyone with the link can join a list. |
| Embed | Putting a list's sign-up form on your own website with a short code snippet. |
| Consent record | The stored proof of a public sign-up: the exact sentence shown, the page, the address, the time and, once confirmed, the confirmation time. |
| Campaign template | A saved campaign design, made with Save as template in the campaign designer. |
| Email template | A template for one of the system's own emails, such as a recall notice or a hiring notice. Unrelated to campaigns. |
| Notification group | A named, reusable group of people. Mass Message can target one; campaigns cannot. |
| Message History | The delivery log for Mass Message and every system notification. |
| Origin chip | The CRM or Mass Communication label under a campaign's name, showing where it was created. |
Mass Message or Campaigns?
Use this table whenever you are about to send something to more than a handful of people.
| Mass Message | Campaigns | |
|---|---|---|
| Who it reaches | Your workforce: people in your projects, groups, companies, roles, duties and locations | Subscribers on your lists, Tansi users and pasted addresses |
| Channels | Email, SMS / MMS and in-app push | Email only from this module |
| How you write it | A rich-text editor per channel | The block canvas designer |
| Saved as a draft | No — close the page and it is gone | Yes — edit, schedule, cancel, duplicate, resend |
| Tracking | None | Opens, clicks, bounces, unsubscribes, polls |
| Unsubscribe link and mailing address | None | Added to every email, automatically |
| Honors opt-outs | No | Yes, checked again at the moment of sending |
| Where results appear | Message History | The campaign's own report |
| Merge tokens | {{first_name}}, {{last_name}}, {{company}}, {{role}}, {{duty}}, {{project}} | {FirstName}, {LastName}, {CompanyName} |
| Languages | English screens only | English, French and Spanish screens |
If you would be comfortable with every recipient asking why did I get this? and the answer being because you work on this project, use Mass Message. If the honest answer is because you signed up, use Campaigns.
Pasting text from one tool into the other leaves its merge tokens showing to the reader. Mass Message only replaces its six double-brace tokens; Campaigns only replace their three single-brace ones.
Campaigns cannot send a text message from Mass Communication — the channel choice is hidden and email is forced. For SMS to your workforce use Mass Message; for SMS to leads and contacts use CRM Campaigns.
Mass Message: projects, channels and recipients
Open Mass Communication › Mass Message. The page subtitle sums it up: Pick the project(s), choose who gets it and how, write it once — Tansi formats per channel and sends in batches. Work down the left column; the right rail, Batching & Delivery, keeps a running plan of what will happen.
The Mass Message page is not translated. Its labels stay in English whichever language you have chosen for Tansi.
Step 1 — Projects
The Projects card is required. It scopes both who you can reach and which saved templates you can use.
- Select Select project(s)… to open the picker.
- Search by name or status, then tick one or more projects — or tick ALL PROJECTS — whole directory.
- Check the line underneath, {n} people in scope.
Ticking ALL PROJECTS clears your individual picks, and ticking a project clears ALL PROJECTS. Your choices appear as chips you can remove.
If a template is loaded and you change the projects so that template is no longer in scope, it is cleared without a message. Re-check the Template box after changing projects.
Step 2 — Channels
Tick any of Email (on by default), SMS / Text and In-App Push. A person missing an address for one channel is skipped on that channel and still reached on the others.
Step 3 — Recipients
Search by name, company, role, duty, location or group. Each pick becomes a token:
| You pick | It reaches |
|---|---|
| A person | That one worker. |
| A notification group | The active members of that group. |
| A company | The people of that company in scope. |
| A role | Everyone with that job title in scope. |
| A duty | Everyone assigned that duty. |
| A location | Everyone at that location. |
| A typed email address or phone number | That address only, marked MANUAL. |
| Add everyone in {scope} | Every worker in the chosen projects. Under ALL PROJECTS it also includes workers not assigned to any project. |
Four tiles count Recipients, Email, SMS and In-App, each with how many are missing an address for that channel. A line beneath reports duplicates merged and people removed by hand. People who appear through two tokens get one message, not two.
The list below can be narrowed with Filter this list… and the chips All, Employees, Contacts, No email and No mobile. Each row shows a type chip — EMP, EXT or MANUAL — and channel icons that turn green when that person can be reached on a channel you switched on.
Selecting × on a row drops that person, and there is no way to put them back except reloading the page. A MANUAL row has no × at all — a typed address stays until you reload.
Before an urgent send, select No mobile to see who will miss the text. Those are the people to phone.
What the empty states tell you
| You see | Because |
|---|---|
| Select at least one project. Recipients and templates are scoped to it. | No project is picked; the recipient search and the Template box are disabled. |
| No recipients yet — search above by name, company, role, duty, location or group. | A project is picked but no one is added. |
| No projects match. | The project search found nothing. |
| ({n} missing) on a count tile | That many recipients have no address for that channel. |
| Could not resolve recipients: … | Building the list failed; try again. |
Under each person, a gray line gives their role, company, duty and project. Filter this list… searches name, email, mobile, company, role and duty.
Mass Message: writing the message
The Message card starts with a Template box (No template — write from scratch, then each saved template, marked (ALL) when it is available to all projects). Below it are four tabs. A tab is disabled while its channel is off.
| Field | What it does |
|---|---|
| From (sending identity) | Department, Name and an optional Email. This is the display name readers see, built as Department — Name; the Email only reaches readers if you insert + Sent from. The real sending address is always your workspace's verified address. |
| Reply-to | Department, Name and Email. Where replies go, so the message is not a no-reply. The Email field sets the actual reply address. |
| Subject | With + First name and + Project insert buttons. |
| Body | A rich-text editor with formatting, colors, alignment and lists. |
| Insert chips | + First name, + Last name, + Company, + Role, + Duty, + Project, plus + Sent from and + Reply-to, which add a line naming the sender or reply address. |
Every insert button adds its token to the end of the field, not where your cursor is. Insert first, then cut and paste the token into place.
SMS
Type into Text message. A live counter shows characters and segments, at 153 characters a segment. Pull from email copies the email body as plain text, cut to 320 characters. The same six merge chips are available.
The Sender ID select (Default (short code) or Dispatch line) is not passed to the sender. Texts always go from the workspace's normal number.
In-App
Enter a Title and Body, or use Pull from email (title from the subject, up to 60 characters; body up to 160). The tab also offers Priority, an Action button, a Deep link and a Require acknowledgement switch.
Priority, the action button, the deep link and acknowledgement tracking are shown on the form but are not delivered with the notification. Do not rely on them for an acknowledgement you need to prove.
Attachments
Add up to 20 files of up to 20 MB each. By email they are real attachments. By text, an image turns the message into an MMS (a warning says it will be billed as MMS) and any other file is added to the text as a secure link. In-app notifications do not carry attachments.
A file that turns out to be empty or unreadable is dropped from the email without stopping the send. It shows only as a line in the Failure reasons list afterward.
Saving a template
Select Save as template to keep the message for next time. Give it a name and description, choose Available to all projects if it should appear everywhere, and tick which parts to store: Email, SMS, In-App, Attachments. Parts you leave unticked are left alone when the template is applied later.
Mass Message has no drafts. If you are writing something long, save it as a template as you go — closing the page loses everything else.
- Available to all projects starts on, and is forced on when the scope is ALL PROJECTS. Turn it off to keep the template to the projects you have picked.
- With a template loaded, the name starts as {template} (copy). Saving always creates a new template; you see Template "{name}" saved. A blank name gives Give the template a name.
- Loading a template shows Template "{name}" loaded. Its attachments are added to any already attached, not swapped in.
No screen renames, changes or deletes a Mass Message template. A corrected version is a new template beside the old one, so name them clearly, for example with a date.
Defaults and details
The From Name starts as your name, and the From Email (optional) and Reply-to Email start as your own address. The display name readers see is built as Department — Name. The From email is only shown to readers if you insert + Sent from, which adds a line Sent from: …; + Reply-to adds Reply to: …. Both do nothing while their fields are empty.
The In-App tab has its own short set of inserts — + First name, + Project and Pull from email. Priority offers Normal, High — banner and Critical — bypass DND; Require acknowledgement starts on. Pull from email on the SMS tab says Email body is empty when there is nothing to copy. The Attachments ({n}) tab uses Add files; a file that cannot be uploaded shows Could not upload {file}: ….
Mass Message: batching, testing and sending
Batching & Delivery
| Control | Default | What it does |
|---|---|---|
| Batch size | 50 | How many messages go in each batch. Presets 25, 50, 100, 250 and All; 0 sends everything as a single batch. |
| Pause between batches | 30 seconds | No pause, 15 seconds, 30 seconds, 1 minute, 5 minutes or 15 minutes. |
| Stop on failure threshold | On | Halts the run if a batch has more than 10% bounces. Only checked between batches. |
| Suppress duplicates | On | Shown for reassurance. Duplicates are always merged, whatever this switch says. |
| Respect quiet hours | Off | With SMS or In-App ticked and no schedule set, holds the whole send until 7:00 a.m. local when it would otherwise start before 7:00 a.m. or after 10:00 p.m. |
| Schedule for later | Off | Reveals a date and time. |
The plan panel lists projects, template, recipients, channels, Messages to send, Batches, Estimated duration and attachments, with a small bar for each batch.
300 people on all three channels is 900 messages — 18 batches of 50, about nine minutes with a 30-second pause.
The label says Hold SMS & push until 07:00 local, but the whole send waits, email included. Turn it off for an emergency.
Preview and test
Preview message shows each channel as the first person on your list would see it: an inbox view for email, a phone bubble for text and a notification card for in-app.
Send test to me sends the message to you alone, with [TEST] in front of the email subject and in-app title.
Send test to me goes through the same sender as the real thing. It appears in Message History, carries the real attachments and is not limited in number.
The preview dialog is titled Preview — as {first recipient}. With no channel ticked it says Pick a channel first.; with nobody on the list, Add recipients to preview the merge fields.
Send test to me uses the email and phone on your own profile (your mobile, or your business phone when there is no mobile) and sends the in-app part to you. It shows Test sent ({n} message(s)). or Test failed: …
Respect quiet hours only takes effect when SMS / Text or In-App Push is ticked. An email-only send ignores it. It is also ignored when Schedule for later is on — the time you pick wins.
Estimated duration allows about two seconds per batch plus the pause between batches. Schedule for later starts with today's date and 9:00. The plan panel draws up to 24 batch bars, then +{n}.
Review and send
- Select Review & Send (or Review & Schedule when a time is set).
- Check the plan and the Send time in the dialog.
- Select Send now or Schedule send.
- Read the result: messages queued across batches, a per-channel sent and failed count, and up to eight failure reasons. Select Done.
The button stays disabled while any of these alerts show: Select at least one project., Select at least one channel. or No recipients selected yet.
Once sent, a Mass Message cannot be stopped. A scheduled Mass Message cannot be canceled from any screen either, so double-check the time before you schedule.
Emergency broadcast
The red Emergency broadcast button in the header sets ALL PROJECTS, turns on all three channels and adds Everyone in the whole workforce. It does not send — you still write the message and press Review & Send.
Emergency broadcast discards your project picks and any existing Everyone token without asking.
Where the results go
Email and text results are logged in Message History under a name such as Mass Message 2026-11-14 09:30. In-app sends are not logged anywhere — note the counts in the result dialog before you close it.
Campaigns from Mass Communication
Mass Communication › Campaigns opens the same campaign list, editor, canvas and report described in Module 04 — CRM Campaigns. Read that module for the full walk-through. This section covers only what is different from this side.
| From Mass Communication | |
|---|---|
| Subtitle | Email your users and subscribers |
| Audience sources | Subscriber lists (each shown with its subscribed count), Or paste email addresses, and Tansi users |
| Channel | Email only — there is no channel choice |
| CRM record types | Not offered (no Leads, Contacts or Event attendees) |
| The list | The whole workspace pool, with a CRM or Mass Communication chip under each name |
| A campaign that reaches CRM people | Read-only unless you also have CRM access: the Audience column reads Includes records you don't have access to, there is no row menu, and the report shows headline rates only |
If you hold both CRM administration and Mass Communication access, you see every audience source and the channel choice from either menu.
A carefully built notification group will not appear in the campaign editor. Campaigns reach lists, Tansi users and pasted addresses only.
Duplicate on a campaign's report page labels the copy CRM, even from here. Use Duplicate in the list's row menu to keep the Mass Communication chip.
A Campaigns page or report you cannot open shows Campaigns aren't available here; the report version also has a back link to the list.
Lists
Lists holds your mailing lists, subtitled Groups of subscribers you can send campaigns to.
| Column | Shows |
|---|---|
| List | The name, linking to Subscribers filtered to this list, with the description underneath. |
| Opt-in | Single or Double. |
| Subscribers | People subscribed to the list. |
| Unsubscribed | People who left the list. |
| Public sign-up form | On with a Copy link button, or Off. |
| Last campaign | The date of the latest campaign that drew anyone from this list. |
| Actions | Share & embed, Edit and Archive. |
People awaiting confirmation on a Double list are counted in neither column, and a hard-bounced address still counts as subscribed here. The Subscribers page and the send itself know better.
Creating a list
- Select New list.
- Enter a List name (up to 150 characters) and, if you like, a Description (up to 500). Subscribers see both on the sign-up page.
- Choose the Opt-in: Single — people are subscribed right away or Double — people confirm by email first.
- Turn on Public sign-up form if people should be able to join from a link.
- Select Save.
As the dialog's hint says, people you add by hand or import are subscribed immediately, even on a Double list, with no confirmation email.
Public sign-up form starts off in the dialog. Save stays disabled until there is a name. You see List created or List saved. If a field is too long: Check the name (150 characters max) and description (500 characters max).
Copy link on a row shows Sign-up link copied. If your browser blocks the clipboard, the message shows the link so you can copy it by hand. The export menu saves the table, with the live sign-up link in the Public sign-up form column.
Share & embed
The share icon on a row opens the list's Share & embed page: Put this list's sign-up form on your website, or share its link. If the public sign-up form is off, a banner asks you to turn it on first.
- Link — the public address of the sign-up page with Copy link, for an email signature, a website button or a QR code.
- Ask for name — shows optional first and last name fields on the embedded form. Email is always asked.
- Style — inline on the page, or a floating button in the bottom corner with its own text in each language (up to 40 characters).
- Allowed websites — up to 20 addresses, such as https://www.example.com or *.example.com. The form only loads on these sites.
- Look — accent color, form language (or match the visitor's browser) and whether to show the Tansi logo.
- Code — step-by-step snippets for WordPress, Wix, Squarespace and plain HTML, a ready-made AI prompt, and the link, each with Copy code.
Changes are held in a bar at the bottom with Discard and Save changes. The preview shows the saved accent color and logo, not unsaved edits.
Embedding needs the workspace's Embeddable Forms option; without it only the Link tab shows. Editing embed settings needs Edit access to list embeds.
A list's sign-up link is fixed when the list is created. There is no lock or regenerate button. If the link leaks or a printed QR code must be retired, archive the list and create a new one. Exporting the Lists table exports these live links, so store the file carefully.
If the list's public form is off, the banner Turn on the public sign-up form for this list to embed it. has an Edit list button. A list that was archived shows This list was not found or has been archived. An address that cannot be allowed is refused with "{address}" can't embed this form. Use a website address such as https://www.example.com, or *.example.com for all subdomains. Ask for name only appears when embedding is available, and is read-only without edit rights.
Archiving
Archive asks for confirmation: the list's subscribers and opt-outs are kept, and campaigns already sent are not affected. The list then disappears from every screen and its sign-up link — and any embed of it — stops working at once.
No screen shows archived lists, so archiving is permanent in practice. Its opt-outs still count, which is what you want.
Subscribers
Subscribers lists people on your lists who aren't Tansi users. A subscriber is not a separate kind of record: it is a CRM contact with a membership on one of your lists. If the address already belongs to a contact, that contact is reused — your best client added to a newsletter stays a full contact.
Search by name or email, and filter by List and Status. Each row shows the name, email, a chip for every list the person is on, a status and the date added.
| Status | Means |
|---|---|
| Subscribed | On at least one list, nothing blocking. |
| Awaiting confirmation | Signed up on a Double list and has not clicked the confirmation link. |
| Unsubscribed | Left the list, or unsubscribed from everything. |
| Bounced | Mail to the address failed permanently. |
With a List filter on, the status describes that one list, while the chips still show every list. Unsubscribed beside three chips is normal.
Adding a subscriber by hand
- Select Add subscriber. It is disabled until at least one list exists.
- Enter the Email — a bare address, not Name <address> — and, optionally, the first and last name.
- Choose at least one list under Add to lists.
- Save. You are recorded as the source of their consent.
If the address unsubscribed or bounced before, the dialog refuses: This address unsubscribed or bounced, so it can't be added again here. There is no override. The only way back is for the person to sign up again and confirm it themselves.
Removing someone from a list
Select × on a list chip. This deletes their sign-up record for that list, including where it came from; adding them back later records you as the source instead of their own consent.
- Someone who unsubscribed cannot be removed: the page says This person unsubscribed; their opt-out is kept. That record is what stops a later import adding them back.
- Someone awaiting confirmation has no × at all.
An unsubscribe, a bounce or a do not email flag on any contact with the same address — even a deleted duplicate — blocks that address everywhere in the workspace.
Shortcuts and confirmations
Opening Subscribers from a list's name filters to that list, and Add subscriber and Import CSV then pre-tick that list. Removing someone from a list asks first: Remove {name} from "{list}"? Their sign-up record for this list is deleted; adding them back later records you as the source instead of their own consent. A successful add shows {email} added. With nobody found: No subscribers found — Add people one at a time, import a CSV, or turn on a list's public sign-up form.
Importing subscribers
Import CSV on the Subscribers page brings in many people at once.
- Select Choose a CSV file. It needs a header row and can be up to 10 MB and 50,000 rows.
- Check the column mapping. Each CSV column saves as (skip), Email, First name or Last name. Tansi recognizes common headings in English, French and Spanish, such as email, courriel, correo, prénom and apellido.
- Pick at least one list under Add to lists.
- Read the preview: how many will be added, how many are already subscribed, how many unsubscribed before and will be left alone, and how many addresses are invalid.
- Tick I confirm these people agreed to receive email from us.
- Select Import.
Imported people are subscribed at once, even on a Double opt-in list, and no confirmation email is sent. Only import people who agreed to hear from you, and keep your own record of how they agreed.
| Good to know | Detail |
|---|---|
| Duplicates | Only the first row for each address is used; later duplicates are dropped and counted in nothing, so the preview may not add up to the file's row count. |
| Separators | Commas or semicolons, detected from the header line. |
| Previously unsubscribed | Left alone. An import never re-subscribes anyone. |
| Stopping | Stop keeps the rows already saved. Import the same file again to finish; nobody is duplicated. |
| Closing | While an import runs, the dialog closes only with its own button. |
Messages during an import
| Message | Means |
|---|---|
| Import done: {a} added, {u} updated, {p} previously unsubscribed left alone, {i} invalid skipped. | The import finished. |
| Import stopped. Rows already saved are kept; import the same file again to finish. | You pressed Stop. |
| This file is larger than 10 MB. | Split or trim the file. |
| This file has more than 50,000 rows. Split it into smaller files. | Too many rows. |
| This file has no rows to import. | Only a header, or empty. |
| This file couldn't be read as a CSV. | Save it again as CSV. |
| Choose which column holds the email address. | No column saves as Email. |
| Pick at least one list to see what the import will do. | No list ticked yet. |
Import stays disabled until there is a file, an email column, at least one list and the consent tick. While it runs the button reads Importing {n} rows….
Sign-up, confirmation and unsubscribe pages
These pages need no sign-in — the link identifies the list or the person. Each has an English, French and Spanish switcher at the top and names your workspace.
The sign-up page
The public sign-up link shows the list's name and description, Email, First name, Last name, the sentence By subscribing you agree to receive emails from {Workspace}. You can unsubscribe at any time. and a Subscribe button.
| What happened | What the visitor sees |
|---|---|
| New address, Single list | You're subscribed |
| New address, Double list | Check your inbox — a confirmation email is on its way |
| Unsubscribed before, any list | Check your inbox — they must confirm to come back |
| Already subscribed, bounced or complained | The same success screen, on purpose |
A visitor can never tell whether an address is already on the list, or has bounced. That protects your subscribers' privacy — but it also means a success screen does not prove someone was added.
Sign-ups are limited to five every ten minutes from one internet address. A whole office behind one connection shares that limit: Too many attempts. Please try again later.
The confirmation email and page
On a Double list the person receives Please confirm your subscription to {Workspace}, in their own language, with a Confirm my subscription button. The link works once and expires after 7 days.
Opening the link does not confirm anything — the person must press Confirm my subscription on the page. Mail security scanners open every link in a message, and this stops them confirming on the person's behalf.
Ask them to submit the sign-up form again. That sends a fresh confirmation link.
The unsubscribe page
Every campaign email ends with an Unsubscribe link. Mass Message emails have none.
- Unsubscribe from these lists — leaves only the lists that campaign was sent to. Other campaigns can still reach the person, and the page says so.
- Unsubscribe from all emails from {Workspace} — blocks the address for every campaign and leaves every list.
As with confirmation, opening the page changes nothing until a button is pressed. A broken or old link shows This link isn't valid.
A hard bounce or a spam complaint is permanent — not even the person confirming a new sign-up can undo it.
Consent records
Each public sign-up stores proof for CASL: the exact sentence shown, the page, the address, the language, the time and, once confirmed, the confirmation time.
| Where they signed up | Consent shown |
|---|---|
| The sign-up link | The By subscribing… sentence, with no tick box |
| A form embedded on your website | A required tick box: Yes, I want to receive emails from {Sender}. I can unsubscribe at any time. |
| A CRM lead form linked to a list | An optional tick box: Also keep me updated by email from {Sender}. I can unsubscribe at any time. |
{Sender} includes your website when one is set in your booking branding, so the sentence identifies you the way CASL expects. Sign-ups through a booking page store no consent record — only the fact that they came from a booking.
Other states of these pages
| Page | You see | Because |
|---|---|---|
| Sign-up | This sign-up form isn't available. — The link may be out of date, or the list is no longer accepting sign-ups. | The form is off, the list is archived, or the link is wrong. |
| Sign-up | Enter your email address. / Enter a valid email address. | The email is missing or badly formed. |
| Confirm | Your subscription is confirmed | The button was pressed in time. |
| Confirm | This link isn't valid — The confirmation link has expired or has already been used. You can sign up again from the original form. | Older than 7 days or used. |
| Unsubscribe | You've been removed from these lists | They left the listed lists. |
| Unsubscribe | You're unsubscribed / You're already unsubscribed | They left everything, now or earlier. |
Campaign Templates and Email Templates
The two template pages sound alike but manage completely different things.
| Campaign Templates | Email Templates | |
|---|---|---|
| What they are | Saved campaign designs | The system's own emails, such as notices and alerts |
| Used by | The campaign designer | Tansi's notification system — not campaigns, not Mass Message |
| Made where | In the campaign designer, with Save as template | On this page, with Create template |
| Belongs to | The workspace | A company in the workspace |
Campaign Templates
A plain table of Name, Created and Last changed, with a delete icon per row. A template keeps the whole design — every block and the email styles — but not the audience, subject or schedule.
To make one, open a campaign's Compose step, type a Template name and select Save as template. To use one, choose it from the Templates menu on the canvas or from the Start with choices.
You cannot see a template from this page or rename it. Deleting one does not change campaigns already made from it, and templates saved from CRM Campaigns appear here too.
Saving a design always creates a new template, so Last changed usually reads —. Two saves with the same name give two templates. Delete asks "{name}" will be deleted. Campaigns already made from it are not affected. and shows Template deleted. The export menu saves the table as Campaign templates.
This page needs Mass Communication access. A user with CRM campaign access only can save templates from the designer but cannot open this page to delete them.
For the full Email Templates walk-through — permissions, every field and message, test sends — see Email Templates in depth.
Email Templates
Three tabs: Templates (name, key, type, status, and Edit, Preview and Send per row), Editor and Preview.
- Select Create template, or the pencil on a row.
- Enter the Template Name, a unique Template Key and the Company it belongs to.
- Write the Email Subject, using double-brace variables such as {{firstName}}.
- Write the content in the HTML editor, or turn off HTML Template for plain text.
- Note the variables you used in Available Variables for whoever edits it next.
- Leave Template Active on and select Save Template.
The row's Send icon opens Preview with the address test@example.com already filled in. Replace it with your own before selecting Send Test Email.
Images pasted into the HTML are stripped when you save, and a message says so. Link to images instead.
Notification Groups and Message History
Notification Groups
A notification group is a named set of people you message often — a site's first-aid team, a night crew. Its active members are who a group token reaches in Mass Message, and automated notifications use groups too.
| Row action | What it does |
|---|---|
| Edit group | Change the name, description and whether it is active. |
| Manage members | Add or remove people. |
| Send notification | Send a message to only this group from here. |
| View notification logs | Meant to list what was sent to the group, but it currently always ends on an access-denied page. Use the Send log tab on Manage members. |
| View details | Goes to an address with no page behind it, so a not-found page appears. Use Manage members instead. |
| Delete | Developers only. Cannot be undone. |
Message History
Message History is the delivery log for Mass Message email and text, and for every notification the system sends. It has six tabs: SMS Conversations, Email Notifications, In-App Notifications, All Notifications, Alert Report and Customize Messages. A Connected chip shows it is updating live.
Campaign sends — open the campaign's report instead — and Mass Message in-app notifications, which are not logged.
The Customize Messages tab is not the Email Templates page. It rewords the subject and message of each automated alert type for your workspace, with its own {Placeholder} chips and a Reset to default button, and it only appears for people with edit access.
Email Templates, Notification Groups and Message History are not translated.
On the Notification Groups list, View Notification Logs currently always ends on an access-denied page and View Details on a not-found page. The Manage Members page has everything: members, adding people, and a Send log. See Notification Groups: the list and its buttons.
Each Message History tab is described in detail in Message History: SMS, email and in-app and Message History: All Notifications, Alert Report and Customize Messages.
Email Templates in depth
Mass Communication › Setup › Email Templates holds the wording of emails Tansi sends by itself, such as a recall notice or a hiring notice. The subtitle says Templates belong to a company in {workspace}. Every template hangs off one company in your workspace.
Who can do what
| You have | You can |
|---|---|
| View access to Email Templates | Open the page, list templates, preview them, send a test and export to Excel. |
| Edit access | Also see Create Template and the pencil on each row, and save changes. |
| No access | See You don't have permission to access this page. |
A Developer working across workspaces gets a workspace picker at the top. Choosing a workspace returns you to the Templates tab and lists that workspace's templates.
The Templates tab
| Column | Shows |
|---|---|
| Name | The template's display name. |
| Key | Its identifier, such as FRN. |
| Type | HTML or Plain Text. |
| Status | Active or Inactive. |
| Actions | Pencil (edit rights only), Preview and Send. |
Only email templates are listed. With none yet you see No email templates found and, with edit rights, Create Your First Template. Export to Excel saves the grid as a file named Email Templates.
Creating or editing a template
- Select Create Template or a row's pencil. The Editor tab opens. A new template starts as HTML and active, and the Company is filled in when your workspace has only one company.
- Fill in Template Name and Template Key (the helper calls it a Unique identifier for this template).
- Pick the Company it belongs to.
- Type the Email Subject. Variables are written in double braces, such as {{firstName}}.
- Write the body. With HTML Template on you get the HTML Content editor: undo, redo, paragraph style, font, size, bold, italic, underline, strikethrough, text and background color, remove formatting, alignment and lists. With it off you get a plain Message Content box.
- Note the variables the template expects in Available Variables. Nothing reads this box; it is documentation for the next editor.
- Leave Template Active on, then select Save Template. You stay on the Editor tab.
| If you see | It means |
|---|---|
| Template Key is required, Template Name is required, Email Subject is required | That field is empty. They are checked in this order. |
| Template content is required / Message content is required | The HTML or plain body is empty. |
| Select a company in the current workspace before saving. | No company chosen, or one outside this workspace. |
| A warning that pasted images were removed | Pictures pasted into the HTML are stripped on save. Link to images instead. |
| Template created successfully! / Template updated successfully! | Saved. |
Switching HTML Template off keeps the HTML body stored but sends the plain Message Content from then on. Check both before you save.
Preview and test
The Preview tab shows the subject and body, and a Plain Text Fallback when a template has one (no field on this page edits it). Preview on the Editor tab shows your unsaved edits. Type an address in Test Email Address and select Send Test Email; you see Test email sent successfully!
Variables are not filled in on a test, so the recipient sees {{firstName}} as typed. The row's Send icon pre-fills test@example.com; replace it with your own address. Tests are logged in Message History like any other email.
No screen deletes an email template. To retire one, turn Template Active off and save.
Notification Groups: the list and its buttons
Notification Groups keeps named, reusable groups of Tansi users — a site's first-aid team, the night shift, the people who must hear about a recall. Mass Message can target a group as one recipient token. Campaigns cannot.
Who can open it
Developers, and people whose role gives them at least View access to this administration page. Others see Access Denied: You don't have permission to view this page. The Manage members page is stricter: it needs an Admin or Developer role and sends anyone else to the access-denied page.
The list
| Column | Shows |
|---|---|
| Group Name | The group's name. |
| Description | Its description. |
| Members | How many people are in it. |
| Created | The creation date, shown day/month/year. |
| Active | Active or Inactive. |
Each column has a filter box under its heading and can be sorted. The export menu saves the list as Notification Groups. With no groups you see No notification groups found. Click "Create Group" to get started.
Creating a group
Select Create Group. The Create Notification Group dialog opens; fill it in and save. You see Group created successfully! Then add people on the Manage members page — a new group starts empty.
The row buttons
| Button | What it does |
|---|---|
| Edit Group | Opens Edit Notification Group. Saving shows Group updated successfully! |
| Manage Members | Opens the group's members page, with tabs for members, adding people and the send log. |
| Send Notification | Opens Send Mass Notification for this group only. A successful send shows Notification sent successfully! |
| View Notification Logs | Goes to the group's log page — which currently always ends on the access-denied page. |
| View Details | Goes to an address with no page behind it, so you see a not-found page. |
| Delete Group | Developers only. Asks Are you sure you want to delete the group '{name}'? This action cannot be undone. and then shows Group deleted successfully! |
View Notification Logs always lands on an access-denied page, even for administrators, and View Details lands on a not-found page. To see what was sent to a group, open Manage Members and use its Send log tab. To see who is in it, use the Members tab.
Only Developers can delete a group. An administrator who wants a group out of use can edit it and make it inactive.
Managing a group's members and send log
Open a group with Manage Members. The page header shows the group's name and description, an Active or Inactive chip and the member count. Breadcrumbs above it lead back to Notification Groups. The page has three tabs.
Members
A grid headed Group Members ({n}) with First Name, Last Name, Email, Phone and Added Date. Every column can be filtered and sorted, the grid pages, and the export menu saves it as Group Members.
The red button on a row removes that person at once and shows Removed {name} from the group.
One click on the red button removes the member. If you remove someone by mistake, add them back on the Add people tab.
An empty group reads This group has no members yet. Use the Add people tab to add users to this group.
Add people
- Type at least two characters of a name or email in Search Users to Add.
- Press Enter or select Search Users. Fewer than two characters shows Please enter at least 2 characters to search.
- Under Available Users ({n}), select the green + beside each person to add. People already in the group are left out of the results.
- Each add shows Added {name} to the group. Select Refresh to reload the members and the send log (Data refreshed).
Only Tansi users can be members. People are added one at a time; there is no bulk add.
Send log
Headed Notification Logs ({n} messages sent), one row per message sent to the group.
| Column | Shows |
|---|---|
| Type | The channel of the message. |
| Subject | Its subject. |
| Sent Date | When it was sent. |
| Total Recipients | How many people it was addressed to. |
| Successful / Failed | How many sends worked and how many did not. |
| Status | Sent or Delivered in green, Failed in red, Pending in amber. |
| Details | Opens the Delivery Report for that message. |
The export menu saves it as Group Message Log. With nothing sent yet: No notifications have been sent to this group yet.
If the address you opened does not match a group you see Group not found or Invalid group ID and return to the list.
Message History: SMS, email and in-app
Message History is the record of what Tansi's notification system sent, and of texts people sent back. Mass Message emails and texts land here too. Campaign sends do not — open the campaign's report for those.
The page needs the Notifications permission in Safety & Compliance. If your permission is limited to your own items, every tab shows only messages that belong to you. A Developer gets a workspace picker. Each tab loads the first time you open it, so a long history does not slow the page.
SMS Conversations
Texts are grouped into conversations, one card each, 24 cards per page. A chip beside the heading shows the live connection: Connected, Reconnecting..., Disconnected or Failed to connect. While connected, a new incoming text refreshes the cards and shows New SMS message received.
| On a card | Means |
|---|---|
| Name and number | The person, with the raw number underneath when a name is known. |
| Date | The last activity, such as Nov 14, 09:30. |
| {n} messages | How many texts are in the thread. |
| → / ← and text | The latest message, outgoing (→) or incoming (←), cut at 50 characters. |
- Select View Conversation on a card. The dialog Conversation with {name} shows every message, yours on the right in green.
- Type in Reply message and select Send. You see SMS sent successfully and the thread scrolls to your reply.
- Select Close when done.
Send SMS opens the Send Notification dialog set to SMS; Refresh reloads the cards. With nothing yet: No SMS conversations found.
Email Notifications
Headed Recent Email Notifications, with Send Email and Refresh. The grid shows 25 rows a page.
| Column | Shows |
|---|---|
| (arrow) | Expands the row to show recipient, alert type, channel, created, sent, delivered, read and the full message. |
| Date | When the email was created. |
| Email Address | The recipient. |
| Subject | The subject line. |
| Content | The first 80 characters. |
| Status | Pending, Sent, Delivered, Read or Failed. |
| Sent At | When it went, or Not sent. |
| Actions | The eye opens Email Details; Retry Send appears on a failed email. |
Email Details shows To, Status, Sent, Created, the provider's Message ID, the Subject, and the Content — with Rendered and HTML Source tabs for an HTML email — plus Error Details when it failed.
Retry Send sends the same subject and content to the same address again and shows Email resent successfully! Read the error first: a bad address will only fail again.
In-App Notifications
Headed Recent In-App Notifications, with Send In-App Notification. Columns Date, Subject, Message (first 50 characters), Status and User, with the same expandable detail. Mass Message in-app sends are not logged here.
Each grid's export menu saves the rows it has loaded: Email Notifications or In-App Notifications.
Message History: All Notifications, Alert Report and Customize Messages
All Notifications
Every channel in one grid, with Send Notification at the top and four filters: Alert type, From, To and Status. The filters are grayed out until a workspace is chosen.
| Column | Shows |
|---|---|
| Date | When it was created. |
| Type | Email, SMS or InApp. |
| Alert Type | The automated alert that produced it, if any. |
| Recipient | Who received it. |
| Subject | The subject. |
| Status | The delivery status. |
| Direction | An arrow: incoming or outgoing. |
Each column also has its own filter box. The grid holds the newest 500 matching messages.
The export menu on All Notifications re-reads up to 10,000 messages that match your filters, not only the 500 on screen.
Alert Report
Only automated, outgoing alerts — low stock, expiring lots, request reminders and the like. Filters: Alert type (grouped by category), From, To, Channel and Status. The grid pages on the server (25, 50 or 100 rows) with Date, Alert Type, Channel, Recipient, Subject and Status, and rows expand for the full message.
The export takes every matching alert up to 10,000, strips formatting from the message and records the filters you used (for example Type: Low stock · Channel: Email, or All alerts). Without a workspace you see Select a tenant to see its alert history.; with nothing matching, No alerts match the current filters.
Customize Messages
Shown only to people with edit access. It lets your workspace replace Tansi's standard wording for each alert type: Customize the subject and message Tansi sends for each alert type. Alerts without a customization use the standard Tansi wording.
Customize Messages and Email Templates store different things. Changing an alert here does not change any email template, and the other way round.
- Find the alert type in its category. A Default chip means standard wording; Customized shows your subject underneath.
- Select the pencil. The dialog Customize: {alert type} opens.
- Type the Subject (up to 300 characters) and the Message.
- Click a placeholder chip, such as {ItemName}, to add it. It is always added to the end of the Message, so cut and paste it into place, or type it into the Subject yourself.
- Read Preview with sample data under the fields.
- Select Save (it needs both fields). You see Custom message saved for "{type}".
To undo a customization, open it and select Reset to default: "{type}" reset to the default Tansi message. The Sharing tab's fixed invitation and upload-request emails are not listed, because they always use Tansi's wording.
The preview fills placeholders with fixed sample values from a clinic's stock room — Influenza Vaccine, VAX-001, Main Depot, Weekly clinic order. Alerts are not limited to medical supplies: the real alert uses your own item, lot and location, whether that is hard hats, pallets of drywall or printer toner.
An alert body written here is always displayed as plain text in Message History, even if it looks like web code. Only Tansi's own system emails and digests render as formatted email.
Sending a one-off notification
The Send SMS, Send Email, Send In-App Notification and Send Notification buttons on Message History all open the same Send Notification dialog, with the type set to match the button. It sends to one recipient. For many people use Mass Message.
- Choose the Type: Email, SMS or In-App.
- For In-App, search the User box (at least two characters of a name or email). In-app notifications only reach registered users.
- For Email or SMS, choose Send to Registered User and search for them, or Send to Email Address / Send to Phone Number (including non-registered) and type the address or number. The second choice is selected when the dialog opens.
- Type the Subject and Message. Every field is required; Send Notification stays disabled until they are filled in.
- Select Send Notification. You see Notification sent successfully and the matching tab refreshes.
| Message | Fix |
|---|---|
| User does not have an email address on file. / …phone number on file. | Pick another channel, or type the address directly. |
| The selected user no longer exists. | Search again. |
| Invalid email address format. | The address has no @. Correct it. |
| Phone number is required. | Type a number. |
| Error sending notification: … | The send failed; the reason follows. |
Use it for one person and one message: telling a single contractor their gate code by text, emailing a supplier who is not a Tansi user, or nudging one employee in the app. For a crew, a site or a project use Mass Message; for anything promotional use Campaigns.
The message is logged like any other notification, so it appears on the matching tab of Message History straight away, and an SMS starts or continues a conversation card on SMS Conversations. A reply from the person shows up in that same thread.
An email address is accepted as long as it contains @. A typo such as name@company is sent and fails later; check the Email Notifications tab.
These are operational messages. Do not use this dialog for anything promotional; that belongs in Campaigns.
Worked examples: Mass Message
Example 1 — Closing a flooded yard (construction)
Heavy rain has flooded a pipeline laydown yard. Everyone assigned to that project must know before tomorrow's 6:00 a.m. start.
- Open Mass Communication › Mass Message.
- Under Projects, select Select project(s)…, search for the project and tick it. Check {n} people in scope.
- Under Channels, tick Email, SMS / Text and In-App Push.
- Under Recipients, select Add everyone in {project}.
- Select the No mobile chip and write down who will miss the text. Phone them.
- On the Email tab, write the subject and body. Use + First name, then move the token to the start of the greeting (inserts always land at the end).
- On SMS, select Pull from email and trim to one segment if you can; watch the character counter.
- On In-App, select Pull from email for the title and body.
- Leave Respect quiet hours off. If you send after 10:00 p.m. it would hold the whole send until 7:00 a.m., an hour after the crew has already arrived.
- Select Send test to me and check your own phone and inbox.
- Select Review & Send, check Send time reads Immediately, then Send now. Read the per-channel counts and any Failure reasons before Done.
Example 2 — Night-shift notice with a notification group (warehouse)
A distribution center keeps a notification group Night shift — Dock B. A dock door is out of service tonight.
- Pick the project the warehouse belongs to under Projects.
- Under Recipients, search for Night shift and pick the group token.
- Tick SMS / Text only. With text only, Respect quiet hours matters: at 11:00 p.m. it would hold the text until 7:00 a.m., which is too late for a night shift. Leave it off.
- Write the text, review and send.
A group token reaches whoever is in the group when Mass Message builds the recipient list on the page. Check the Members tab of Manage Members after every roster change.
Example 3 — A scheduled fire-drill notice (office)
A head office runs a fire drill next Tuesday at 10:00 a.m. and wants staff told at 8:00 that morning.
- Pick the office project, tick Email and In-App Push, and add everyone.
- Choose a template if your office saved one (look for (ALL) on shared ones). Loading a template adds its attachments to any already attached, so remove duplicates on the Attachments tab.
- Turn on Schedule for later and set the Date and Time (the time starts at 9:00).
- Select Review & Schedule, check Send time, then Schedule send.
No screen lists or cancels a scheduled Mass Message. Check the date twice.
A note on health and safety alerts
A clinic can use the same steps to tell staff about a vaccine fridge failure, and a school about a lockdown drill. Mass Message is not limited to any industry: it reaches whoever is in the projects you pick.
Worked examples: lists, sign-ups and campaigns
Example 4 — An event sign-up list on your website (events)
A conference organizer wants visitors to its website to sign up for updates.
- Open Lists and select New list. Name it, add a description visitors will see, keep Double — people confirm by email first, and turn on Public sign-up form (it starts off). Select Save; you see List created.
- Select the share icon on the row. On Share & embed, add the website under allowed websites, choose the look, and copy the code for your website builder.
- Turn on Ask for name if you want first and last names. Select Save changes in the bar at the bottom.
- Sign up yourself from the website to test it. You should see Check your inbox, then receive the confirmation email.
Example 5 — Importing an existing customer list (retail)
A hardware store has a spreadsheet of customers who ticked a box at the till agreeing to hear about sales.
- Save the spreadsheet as CSV with a header row.
- On Subscribers, filter List to the target list first — Import CSV then pre-ticks that list.
- Select Choose a CSV file, check that the email column Saves as Email, and read the preview counts.
- Tick I confirm these people agreed to receive email from us and select Import.
- Read the result: Import done: {n} added, {n} updated, {n} previously unsubscribed left alone, {n} invalid skipped.
Imported people are subscribed at once, even on a Double list. Your tick is the consent record; keep the till slips or form that show how each person agreed.
Example 6 — Sending to the list
- Open Campaigns and select New campaign.
- Pick the list under Subscriber lists (each shows its subscribed count).
- Compose, test and schedule as described in Module 04.
Example 7 — I unsubscribed and still got your email
- Ask which button they pressed. Unsubscribe from these lists only leaves the lists that campaign used; other campaigns can still reach them.
- Remember that opening the unsubscribe page changes nothing until a button is pressed.
- Check Subscribers: their status on the list should read Unsubscribed.
- If they want nothing more from you, set the do-not-email flag on their CRM contact, or ask them to use Unsubscribe from all emails on the next email.
- Also check Mass Message: its emails have no unsubscribe link and ignore opt-outs, so an operational notice can still reach them if they are in your workforce.
Every page in this module
Pages you use
| Address | Name | Who can open it |
|---|---|---|
| /safety-compliance/admin/mass-message | Mass Message | Developer, Admin, SuperAdmin |
| /comms/campaigns | Campaigns | Mass Communication access |
| /comms/lists | Lists | Mass Communication access |
| /comms/lists/{id}/share | Share & embed | Mass Communication access; Edit on list embeds to change it |
| /comms/subscribers | Subscribers | Mass Communication access |
| /comms/campaign-templates | Campaign Templates | Mass Communication access |
| /admin/email-templates | Email Templates | Email templates permission |
| /admin/notification-groups | Notification Groups | Notification groups permission |
| /admin/notifications | Message History | Notifications permission |
| Address | Name | Who can open it |
|---|---|---|
| /comms/campaigns/{id} | Campaign report | Mass Communication access |
| /admin/notification-groups/{id}/members | Manage group members | Admin or Developer role |
| /admin/notification-groups/{id}/logs | Notification logs | Nobody at present (always access denied) |
| /safety-compliance/admin/mass-sms | Retired — opens Mass Message | As Mass Message |
| /safety-compliance/admin/mass-email | Retired — opens Mass Message | As Mass Message |
Pages your subscribers see
| Address | Name |
|---|---|
| /subscribe/{token} | Sign-up |
| /subscribe/confirm/{token} | Confirm your subscription |
| /unsubscribe/{token} | Manage your email preferences |
Document & accessibility information
- Module 01
- My Profile — v2.0, November 2026
- Module 02
- Menu Navigation — v1.2, August 2026
- Module 03
- CRM — v1.1, November 2026
- Module 04
- CRM Campaigns — v1.1, November 2026
- Module 05
- Training — v1.0, August 2026
- Module 06
- Assets & Inventory — v2.0, November 2026
- Module 07
- Mass Communication — v1.1, November 2026
- Document
- Tansi Platform — Master Instruction Manual
- Schema
- tansi-doc v1
This file is self-describing: it carries a JSON copy of its own content, so future Tansi modules can be merged into a single master manual without re-authoring anything.
Accessibility
This manual is designed and tested to meet WCAG 2.2 Level AA. That standard is the basis of the accessibility requirements in EN 301 549 (European Union), Section 508 of the US Rehabilitation Act, and the Accessible Canada Act, and it is the standard reported against in an ITI VPAT 2.5 INT (international edition).
What this file supports
- Light and dark themes. Follows your operating system setting automatically. The Dark / Light button in the header overrides it for the current visit. Every color pair in both themes meets or exceeds the contrast minimums — 4.5:1 for body text, 3:1 for interface components and meaningful graphics.
- Full keyboard operation. Nothing needs a mouse. A Skip to main content link is the first item in the tab order, focus is always visible, and there are no keyboard traps. Ctrl + K opens search from anywhere; arrow keys move through the results, Enter opens one, Esc dismisses.
- Screen reader support. Landmarks, a single ordered heading structure, descriptive alt text on every screenshot, row and column headers on every table, and polite live announcements for search results, theme changes and answer feedback.
- Meaning never carried by color alone. Status is always labeled in words as well — Active, Expiring, Expired — and answer feedback uses a symbol and text, not just red and green.
- Adapts to you. Reflows to a 320 pixel viewport (400% zoom) without horizontal scrolling, tolerates increased text and letter spacing without clipping, honours reduce motion, and renders correctly in Windows High Contrast mode.
- Works offline and prints. One self-contained file, no network calls, no cookies, no tracking, and a print stylesheet for paper or PDF.
Known limitations
- Your theme choice is not stored between visits — the file writes nothing to your browser. It follows your operating system preference each time you open it.
- Wide reference tables scroll sideways on very narrow screens. Each one is a keyboard-focusable, labeled region so it can be scrolled without a mouse.
- Screenshots show the Tansi interface in its light appearance in both themes, so that what you see here matches what you will see on screen.
Feedback
If you hit an accessibility barrier in this document, raise it through My Support Tickets in Tansi so it can be logged, tracked and fixed.