Tansi Platform — Master ManualInstruction Manual

You are reading

Tansi
Tansi Documentation

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.

7 modules286 sectionsFull-text searchIncludes admin & manager notesUpdated November 2026
Module 01 · My work

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

Section 0 · Getting oriented · 4 min
What you’ll get: Work out which parts of this module apply to you before you open it.

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

Table: Reader, What this module gives you
ReaderWhat this module gives you
Any signed-in personYour 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 TansiAll of the above, plus the Duties tab and the employer's view of your qualifications, once you pick that company in the header picker.
HROther people's profiles, employee records, and approving or rejecting their qualifications.
Administrator or DeveloperEverything above, plus the Roles and Account tabs for anyone in the workspace you are signed in to.

What access you need

  1. A Tansi sign-in. The page itself asks for nothing more than that.
  2. A candidate profile if you want the Resume Builder, the Looking for Work card or the Qualifications list to show anything.
  3. An employee record at a company if you want the Duties tab and the employer's view of your requirements.
  4. 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.

Read this before you edit anyone else's profile

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

Section 1 · Getting oriented · 4 min
Goal: Recognize the words this module uses before you meet them on screen.

Tansi uses a handful of words in a particular way. Learning them here saves guessing later.

Table: Term, What it means
TermWhat it means
WorkspaceOne 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 profileThe 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 recordYour record at one specific company: job title, department, hire date, salary, duties. One person can have several, one per employer.
Employee modeWhat 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.
QualificationAnything 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 templateA 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-typeThe three levels that categorize a qualification. Type is filtered by the Class you pick, and Sub-type by the Type.
Approve / Reject / BypassWhat 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 statusSends an approved, rejected or bypassed qualification back to pending so it can be looked at again.
Company-level and project-level approvalAn 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 / UnverifiedA 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.
FOIPFreedom 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-identificationThe voluntary statement of Indigenous identity, visible-minority status or neither, used for employment equity. Always optional.
NOC codeThe Canadian National Occupational Classification number for a job, such as 72200. Tansi matches job alerts by NOC group.
Kebab menuThe 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 statusWhere a sign-in account sits in its lifecycle: Invited, On hold, Active, Suspended or Decommissioned.
Public storeAn optional public page listing the courses and webinars you have published publicly. It has its own short handle in the web address.
Idle timeoutThe 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

Section 2 · Getting oriented · 6 min
Goal: Open any profile you are allowed to see and set the two pickers that change what the rest of the page shows.

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.

The top of the My Profile page. A round avatar with a pencil menu on it, the person's name, email and location, a pencil button beside the name, and the Edit Resume and Browse Templates buttons. Above the card sit the View Profile As company picker and the Project Filter (Optional) picker, with chips for job title, workspace name and Current.
The header is the whole module in miniature. The pickers above it decide which employer's version of you the rest of the page shows.

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

Table: What is on the end of the address, What it does
What is on the end of the addressWhat 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.

Admin & manager note

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.

The unsaved-changes warning sticks, and it does not buy you time

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

Section 3 · Your profile day to day · 3 min
Goal: Arrange the two dashboard windows and know where that arrangement is kept.

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 Dashboard tab showing two floating windows on an open canvas, one titled Notifications and one titled My Tasks, each with a maximize control and a drag handle in its title bar.
Two windows you can move and resize. The layout is remembered by this browser, not by your account.

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

Section 4 · Your profile day to day · 7 min
Goal: Read every card on the Overview tab and know which pencil opens what.

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.

The Overview tab as a grid of cards: Looking for Work with a switch, Qualifications Summary with Total, Active, Expiring and Expired counts, Contact Information with a Change button beside the email and a Phone not verified warning strip, Your Signature, Current Employment and Professional Summary.
Everything at a glance. A card you cannot see is a card with no data behind it — cards are left out, not shown empty.

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.

On someone else's profile, this switch changes your own account

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.

Table: Row, What to know
RowWhat 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 verifiedA 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 ContactA 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.
Verify Now on someone else's profile texts them and verifies you

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

Section 5 · Your profile day to day · 7 min
Goal: Work through the five-section Personal Information dialog without getting stuck or surprised.

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).

The Personal Information dialog. A row of section chips reads Basic Info, Address, Emergency Contact, Self-Identification and Gender, with the Basic Information fields below it and Previous, Cancel and Next buttons in the footer.
The one safe place to edit a person's details. The chips let you jump between sections without going through them in order.

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

Table: Section, What it holds
SectionWhat it holds
Basic InformationFirst 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 InformationA 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 ContactEmergency Contact Name and Emergency Contact Phone, both required.
Self-IdentificationVoluntary. Covered in its own section of this module.
GenderOptional, and present only where the workspace collects it. Also covered later.
Emergency Contact is the one step you cannot walk past

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.

Changing the phone number sends a text message straight away

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

Section 6 · Your profile day to day · 9 min
Goal: Find a qualification in any of the four views and add a new one with its documents attached.

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...

The Qualifications tab in card view. Four small view-mode icon buttons sit at the top left, an Add Qualification button at the top right, and each qualification card shows Issued on, Expires on and Provider with a three-dot kebab button in its corner.
One card per qualification. The four icons at the top left switch between card, tile, table and kanban views.

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.

This list is loaded once per visit

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 Add Qualification dialog. A Search qualification by name box sits at the top, then Name, Class, Type and Sub-type fields, Issuing Authority, Issue Date, Expiry Date and a Never Expires switch, with a Supporting Documents block and an Add Documents (PDF, Images) button below.
The manual form behind the AI dialog. Choosing a template fills the top of the form and locks four of its fields.

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.

Table: Field, Required?, Notes
FieldRequired?Notes
NameYesLocked when a template is chosen.
ClassYesThe broad category. Changing it changes the form — see below.
TypeNoFiltered to the Class you picked.
Sub-typeNoUnavailable until a Type is chosen.
DescriptionNo
Number/ReferenceNoThe certificate or licence number.
Issuing AuthorityYesWho issued it.
Issue DateUsuallyCannot be in the future.
Expiry DateUsuallyCannot be in the past.
Never ExpiresSwitchTurning it on removes the expiry requirement.
NotesNo

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.

Files that fail the checks are dropped, not refused

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.

Every image goes through the cropper; PDFs do not

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

Section 7 · Your profile day to day · 7 min
Goal: Use the right action on a qualification card, and know which ones ask before they act.

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.

Table: Menu item, Who gets it
Menu itemWho gets it
ViewAnyone who can see the entry. Opens it read-only.
EditAnyone who can edit this profile, when the entry itself allows editing.
DeleteSame as Edit. Asks for confirmation and cannot be undone.
ApproveAn approver, in employee mode. There must be a company selected.
RejectAn approver, in employee mode.
BypassAn approver, in employee mode.
Reset statusAn approver, in employee mode.
RemoveHR, 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.

Reset status acts immediately, with no confirmation

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

Section 8 · Your profile day to day · 3 min
Goal: Open the Resume Builder from your profile, or fix the one thing that stops it opening.

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.

The Resume Builder tab with the resume editor embedded in the profile page, showing the resume sections down the left and the editing area beside them.
The full Resume Builder, inside the profile. It needs a candidate profile before it will open.

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.

What you write here turns up elsewhere

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

Section 9 · Your profile day to day · 6 min
Goal: Tell the two kinds of work history apart and add to the one you control.

The Employment tab holds two different things that look similar at a glance. Keeping them apart is the point of the tab.

The Employment tab. A verified employment card at the top carries a Verified chip, Department, Position and an employee ID, with View Details and Edit Employee buttons. Below it the Self-Reported Work Experience section shows an entry with an orange Unverified chip and a NOC chip.
Two kinds of job history, kept apart on purpose. The top half is verified by Tansi; the bottom half is what the person typed.

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.

The two sections word employment types differently, on purpose

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.

Admin & manager note

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

Section 10 · Your profile day to day · 5 min
Goal: Read an employee's assigned duties and open the requirements behind one.

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 Duties tab showing the Assigned Duties grid with columns for Duty, Status, Priority, Due Date, Progress, Requirements and Notes, an overdue date in red with a warning icon, and a Duty Summary strip beneath reading Total, Completed, In Progress and Overdue.
Duties only exist in employee mode. Pick a company in the header picker or this tab is not there at all.

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

Table: Column, What it shows
ColumnWhat it shows
DutyThe name of the duty.
StatusAssigned, In Progress, Completed, On Hold or Cancelled. A duty with no status set reads Not Set.
PriorityLow, Normal, High or Urgent. Nothing set is treated as Normal.
Due DateAn overdue date is red and carries a warning icon.
ProgressHow far along the duty is.
RequirementsA button reading {n} requirement or {n} requirements, or None.
NotesAn 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.

Admin & manager note

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

Section 11 · Your profile day to day · 8 min
Goal: Fill in or read self-identification knowing exactly who else can see it.

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.

Privacy and FOIP

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.

The Self-Identification tab with a card headed Indigenous Community showing a chip and rows for First Nation, Residency and Reserve, a Proof of Indigenous Identity (Optional) upload card beneath it, and a Gender card showing Gender and Disclosure rows.
The most sensitive tab in Tansi. Who can see it depends on whether a company is selected in the header.

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.

Table: If you choose, Tansi then asks for
If you chooseTansi then asks for
First NationYour 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étisYour Province of Affiliation. In Alberta you may also pick a Métis Settlement, which is optional and can be cleared back to No affiliation.
InuitYour Inuit Community.
The other threeNothing 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.

  1. Pick an Identification Type: Status Card, Métis Citizenship, Inuit Beneficiary Enrollment or Other. Choosing Other adds a Describe Identification Type box.
  2. Upload an image of the document. You can crop, rotate and adjust it after uploading.
  3. Press Submit for Verification.
  4. 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

Section 12 · For administrators · 5 min
Goal: Give and take away a person's roles, and read what those roles let them do.

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 Roles tab headed Roles in this workspace, with a Give them a role button, a table of Role, What it is for, Since, Given by, Why and Actions columns, and a second section headed What they can see and do listing one chipped permission level per module.
Roles add up. Giving a second role never removes the first, and for each module the strongest role wins.

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.

The profile you are standing on is still somebody else's

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.

This tab is in English only

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

Section 13 · For administrators · 6 min
Goal: Move an account through its lifecycle and read the history of who changed what.

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.

The Account tab. The left column shows Status with a chip, Tansi user ID, Created, Last sign-in and Decommission date, with Send invitation, Suspend and Reinstate buttons. The right column shows Status history as a vertical timeline of transitions with timestamps and reasons.
The account lifecycle in one screen. Every change is written to the timeline on the right, with who did it and why.

What the left column tells you

Table: Field, What it means
FieldWhat it means
StatusA chip reading Invited, On hold, Active, Suspended or Decommissioned.
Tansi user IDThe internal identifier. An em-dash means none has been issued.
CreatedWhen the account was made.
Last sign-inThe date and time, or Never signed in — which on an Invited account usually means the invitation was never taken up.
Decommission dateOr Not scheduled.

The three buttons

Which buttons you see depends on the current status.

Table: Button, When it appears, What it does
ButtonWhen it appearsWhat it does
Send invitationStatus is On holdMoves 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.
SuspendStatus is Active or InvitedBlocks the account, writes an audit record, sends a deactivation notice, and ends every sign-in that account currently has.
ReinstateStatus is SuspendedPuts the account back to work and sends a reactivation notice.
Suspend ends their live sessions, within about thirty seconds

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.

An invitation can half-succeed

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.

This tab is always current

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

Section 14 · Settings and sign-in · 7 min
Goal: Control who can find you, what Tansi emails you about, and your public store page.

Settings is the last tab, and it is always there. It holds four cards, three of which appear on your own profile only.

The Settings tab with four cards: Profile Visibility holding the Public Profile and Actively Looking switches, Job Alerts with a Job Alert Emails switch and a list of NOC occupations, Public store with an enable switch and a Store handle field, and Security with a Change Password button.
Four cards, three of them yours alone. Only Profile Visibility appears when you are looking at somebody else.

Profile Visibility

Table: Switch, What it does
SwitchWhat it does
Public ProfileAllow recruiters to find your profile in searches. Off means you do not appear in recruiter searches at all.
Actively LookingShow recruiters you're open to opportunities. This is the same setting as the Looking for Work card on Overview.
Both switches act on your own account, whoever's profile you are on

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.

  1. Turn on Enable my public store.
  2. Pick a Store handle — the short name in the web address. Lowercase letters, numbers and hyphens, 3 to 30 characters.
  3. Write a Tagline (optional) if you want one line about yourself above the list.
  4. 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.

The rest of your security settings are on another 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

Section 15 · Settings and sign-in · 4 min
Goal: Move your Tansi sign-in to a new address without being caught out by the sign-out.

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 Change sign-in email dialog at its first step, showing the line You sign in with the current address, a New email address field, a Current password field and a Send code button.
Two steps, then a sign-out. Tansi emails a six-character code to the new address before anything changes.
Finish everything else first — this signs you out

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

  1. On Overview, find Email: on the Contact Information card and press Change. The dialog reminds you You sign in with {current address}.
  2. Type the New email address and your Current password. Send code stays unavailable until both are filled in.
  3. 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.
  4. Type the code into Verification code. The confirm button becomes available at exactly six characters.
  5. 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.

The code goes to the new address, not the old one

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

Section 16 · Settings and sign-in · 3 min
Goal: Set a new password that meets all five rules on the first try.

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.

Table: Rule, What counts
RuleWhat counts
At least 12 charactersLength 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 letterA to Z.
A lowercase lettera to z.
A number0 to 9.
A special characterOne 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.

The same rules apply to a new account

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

Section 17 · Language · 5 min
Goal: Switch Tansi into your language and know the two places that stay English.

Tansi runs in three languages. You pick one for yourself, and it follows you.

Table: In the switcher, Language
In the switcherLanguage
EnglishEnglish, and the language Tansi falls back to when a phrase has not been translated yet.
EspañolSpanish.
FrançaisFrench.
The signed-in profile menu opened from the avatar in the top right, with a Language row between Dark mode and Switch workspace, expanded to show English, Español and Français with a tick beside the active one.
The language switcher is in the profile menu. There is no language control on the profile page itself.

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.

Switching language reloads the page

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.

Wording still under review

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

Section 18 · Reference · 3 min
Goal: Find the right address for anything the profile links out to.

The profile is one page with ten tabs, but it links out to a number of others. This is the whole set.

Table: Address, Name, What it is for
AddressNameWhat it is for
/my-profileMy ProfileYour own profile. Opens on the Dashboard tab.
/my-profile/{user id}ProfileSomebody 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 tabOpens 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 viewAdds the Job Match card scoring this person against that job, with Invite to Apply where it applies.
/my-profile?requirementTemplateId={id}Add from templateOpens the Add Qualification dialog already filled in from that template.
/candidate/personal-informationCandidate profileWhere the Complete Profile button goes. Creates the candidate record the Resume Builder and Qualifications need.
/resume-builderResume BuilderThe full resume editor, the same one embedded in the profile tab.
/admin/employees/new/{candidate id}New employeeWhere Add Employee goes. HR, Admin and Developer only.
/admin/employees/assign-duties/{employee id}Assign dutiesWhere Manage Duties and Assign Duties go.
/account/securitySecurity SettingsTwo-factor authentication, remembered devices, sign-in email and password. Reached from the profile menu's Settings item.
/account/notification-settingsNotification SettingsWhich events Tansi notifies you about, event by event.
/my-notificationsMy NotificationsThe full notification list. The Dashboard widget is a short version of it.
/account/set-passwordSet passwordWhere an invitation email lands. Links last seven days; the same five password rules apply.
Tabs, not pages

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.

Module 02 · Everywhere

Menu Navigation

How Tansi is organized and how to move around it — the left menu, the module switcher, the section buttons, menu search, and what every module is for.

Module 03 · Sales & Clients

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

Section 0 · Getting oriented · 4 min
What you’ll get: Decide which parts of the CRM apply to you and check you have the access you need.

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.

Table: Permission, What it unlocks
PermissionWhat it unlocks
CRMThe whole module. Without it the Sales & Clients area is absent.
AccountsThe Accounts list and account records. It also sets the ownership scope for the entire CRM — see the warning below.
ContactsThe Contacts list, contact records, and vCard import and export.
LeadsThe Leads list and lead records, and Lead Forms — both the list and the per-form editor.
OpportunitiesThe Opportunities list, opportunity records, the Pipeline board and Reports.
ActivitiesMy Activities.
EventsThe Events list, event records, check-in, and Spaces & calendar.
Procurement portalsThe Procurement Portals list and its dialogs.
CRM adminCRM Settings, every panel, plus the Chart of Accounts and Campaigns.
One setting decides what the whole CRM shows you

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.

Admin & manager note

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

Section 1 · Getting oriented · 6 min
Goal: Tell an account from a contact, a lead from an opportunity, and know what the CRM means by weighted, converted and archived.

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.

Table: Term, What it means
TermWhat it means
AccountA 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.
ContactA 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 contactThe one person on an account Tansi reaches for first. It shows as a chip on both the account and the contact.
LeadSomebody 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.
OpportunityA deal you are working — a bid, a tender, a quote in progress. It has a value, a stage, a probability and a submission deadline.
StageA column on the Pipeline board. Each stage has a type — open, won or lost — and a probability that drives the weighted forecast.
ProbabilityThe percentage chance of winning, set automatically from the stage and overridable per deal.
Weighted valueEach deal's value multiplied by its stage probability. It is the number to forecast from.
Submission deadlineWhen the bid is due. It is the default sort on the Opportunities list and it drives the countdown on the opportunity record.
ProjectWhat a won opportunity becomes. A project mirrors the opportunity layout and is reached from the won opportunity or the account's Projects tab.
ActivityAnything logged against a record — an email, a text, a call, a meeting, a task, a note, tracked time. Activities make the timeline.
TaskAn activity with a due date and an owner. Open tasks drive My Activities and the Next action card on a lead.
Lead formA 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 formThe lead form that booking pages and calendar invites use. It cannot be deleted until another form is made the default.
PipelineAll your open opportunities, seen as a board of stage columns.
Going coldAn open lead with no activity for a set number of days. The number is a workspace setting, not a fixed value.
ArchivedA record taken out of every list but kept with its history. Archived records are read-only until restored.
Saved viewA named filter across the top of a list, such as Unassigned or Going cold. Views are deep-linkable.
PicklistThe set of choices behind a dropdown — lead status, lead source, account type, activity type, contact type, loss reason.
Custom fieldAn extra field added to one record type. Its key is what exports and integrations use.
Table viewA spreadsheet-style surface on a list or a record, built on Tansi Sheets. It is a permission, not a preference.
Chart of accountsThe account codes that quote, invoice and cost lines are coded against. They belong to one workspace.
WorkspaceOne tenant's CRM. Settings, stages and account codes belong to a single workspace unless you are editing global defaults.
Procurement portalA 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 requestA private page sent to a supplier asking them to price the items on a bid.
PassA ticket type for an event — a price, a quantity, a sales window and a visibility setting.
Attendee typeA networking category for event attendees. It decides who may request meetings with whom, and the band color on a badge.
Client portalA 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

Section 2 · Getting oriented · 5 min
Goal: Find any CRM page from the navigation and recognize the patterns every screen shares.

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.

Table: Group, What is in it
GroupWhat is in it
ClientsCRM Home, Accounts, Contacts — who you sell to.
PipelineLeads, Lead Forms, Opportunities, Pipeline, My Activities, and an alias through to My Booking Pages in the Calendar module.
CampaignsCampaigns. Covered in Module 04.
EventsEvents, and the Spaces & calendar page behind it.
ProcurementProcurement Portals.
InsightsReports.
SettingsChart of Accounts and CRM Settings. Administrators only.
The CRM Overview page. Four key-figure tiles across the top — Pipeline value, Open leads, Open opportunities and My open tasks — each with a small sparkline and a change against the comparison period. Below them a bar chart of open opportunity value by stage, a Leads created line chart, a Needs attention list and a My open tasks list.
The first screen in the CRM. The Compare with control at the top sets the period every figure is measured against, so a tile that looks flat may only be flat against the last 7 days.

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

Section 3 · Clients · 6 min
Goal: Read the overview page and act on the rows it flags.

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.

CRM Overview with pipeline value, open leads, open opportunities and open tasks tiles, the stage chart, leads created, Needs attention and My open tasks
CRM Home. The tiles open the lists behind them. Needs attention counts unassigned leads, deals with no activity in 7 days and opportunities due this week.

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.

Pipeline value is one currency

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:

Table: Row, What it means and what the button does
RowWhat it means and what the button does
Unassigned leadsLeads nobody owns. Assign opens the leads list filtered to them.
No activity in {n}+ daysOpen 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 weekDeals 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

Section 4 · Clients · 8 min
Goal: Find, create and maintain the companies you do business with, and read an account record.

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. A strip of saved views reading All accounts, Customers, Prospects, My accounts and Incomplete. Below it a search box, Type, Industry and Owner filters, a data-completeness banner, and a table with Account, Type, Industry, Phone, Owner, Open pipeline, Contacts and Last activity columns.
Accounts are companies, not people. The banner counts the records missing an industry or a phone number, because an empty field cannot be sorted or filtered on.

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

Table: Column, What it shows
ColumnWhat it shows
AccountThe company name with its website underneath, or No website.
TypeCustomer, prospect, and whatever else your workspace has added to the account type picklist.
IndustryFree text typed on the account, blank where nobody has filled it in. The Industry filter lists the values already in use.
PhoneThe main number.
OwnerWho the account belongs to.
Open pipeline{n} open deals or No open deals.
ContactsHow many people are on file.
Last activityToday, 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 account's preferred method is a default, not a rule

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

An account record. An identity card with the company name, an account number, an owner chip, a primary-contact link and a last-activity chip. Four key-figure tiles for Open pipeline, Won value, Active projects and Contacts, above a tab strip reading Contacts, Opportunities, Projects, Team, Billing, Timeline, Messages, Chat, Notes, Custom fields, Related and Forms.
Every tile is a shortcut. Selecting a key figure jumps to the tab behind it, so Open pipeline takes you to the deals it counted.

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

Table: Tab, What it holds
TabWhat it holds
ContactsThe people at this company, as cards, with channel hints.
OpportunitiesName, Amount, Stage, Status, Close date and Owner.
ProjectsProject number, Name, Contract value, percent complete and Target date. The empty state explains where projects come from: converting a won opportunity.
TeamThe people assigned to this account, with their rates.
BillingBilling detail; it can prompt you to set a missing rate.
TimelineThe full activity feed, with the composer.
MessagesThe SMS conversation. The tab is hidden when the account has no phone number.
ChatRecord chat, through Tansi Chat.
Notes · Custom fields · Related · FormsThe shared surfaces described later in this module.
Project contract values are added up as one currency

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

Section 5 · Clients · 10 min
Goal: Manage the people at your accounts, record how they want to be contacted, and keep a defensible consent trail.

Contacts are people. The list's subtitle is the whole philosophy of the page: Reach the right people, the right way.

The Contacts list in tile view. A toolbar with a live contact count, a search box, filter chips reading All, Primary, Emailable, Opted out, Subscribers only and Hide subscribers, and a view switcher offering Tile, Grid, List and Table. Each card shows a person, their company and a best-channel hint.
Contacts are people. The best-channel hint says whether the channel came from the person's stated preference or was suggested from what is on file.

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.

Subscribers are not customers yet

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.
Importing a vCard never overwrites a record

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 of a contact record, headed Communication preferences. Two switches, Email campaigns and Text messages, each followed by a dated line saying when consent changed and where the change came from. Below them a Best channel selector offering Automatic, Email, Call and Text.
Consent is dated and sourced. Each switch records the day it changed and how — by your team, through an unsubscribe link, from a public form, carried over from a lead, or imported.

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.

Consent is dated and sourced — that is the audit trail

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

You do not choose between archive and delete — the record's history does

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.

A typo in Organization makes a new account

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.

Check the consent chip before texting from the More menu

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

Section 6 · Clients · 4 min
Goal: Find an archived lead or contact, understand why it was archived instead of deleted, and restore it.

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

  1. Open the archive and select the person.
  2. 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.
  3. Select Restore in the header.

Tansi confirms with Contact restored. and the person returns to every list, with their timeline, notes and documents intact.

Admin & manager note

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.

Old deletions live here too

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

Section 7 · Pipeline · 7 min
Goal: Work the leads list, use its saved views, and understand what going cold means.

The Leads list at /crm/leads is where new interest lands before it becomes a customer. Its subtitle is Track and qualify new leads.

The Leads list. Saved views with counts beside each reading All, My leads, Unassigned, New this week, Going cold, Converted, Emailable and Opted out. A toolbar with search, a Source filter, an Organization autocomplete and a view switcher offering Kanban, Tile, Grid, List and Table.
Saved views are the fast path. Going cold uses the day count set in CRM Settings, and the view is deep-linkable, so you can bookmark it.

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.

Table: View, What it holds
ViewWhat it holds
AllEvery active lead.
My leadsLeads you own.
UnassignedLeads with no owner. The first place to look each morning.
New this weekRecently created leads.
Going coldOpen leads with no activity for the workspace's threshold.
ConvertedLeads that became contacts. They appear in no other view.
EmailableLeads you may email.
Opted outLeads 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.

Half-typed text in the Organization filter does nothing on purpose

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

Table: View, The rule
ViewThe rule
New this weekCreated in the last seven days.
Going coldNot converted, and the later of its last edit and its newest activity is older than the threshold.
EmailableHas an email address and has not opted out of email.
Opted outOpted 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

Section 8 · Pipeline · 8 min
Goal: Read a lead record at a glance and convert a qualified lead into a contact, an account and a deal.
A lead record. A progress path reading New, Working, Qualified, Converted with the current step marked. A Next action card showing the earliest open task with Mark done and Open task buttons. Panels for Contact details, Lead details and About, and a tab strip below.
The path says where the lead stands. When a status is not on the path, Tansi says so in words rather than guessing a step.

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.

Last contact counts conversations, not paperwork

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

  1. Open the lead and select Convert lead.
  2. Decide whether to tick Also create an opportunity.
  3. 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.
  4. 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.
A converted lead leaves the Leads area

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

Section 9 · Pipeline · 10 min
Goal: Build a public lead form, route its submissions, and share or embed it without breaking the link.

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 Lead Form editor. Header buttons read Keyboard, Open public form and Save changes. Pills below the title read Live, Link locked, 13 of 13 fields shown and 4 required. A Form fields table lists each field with its order arrows and Shown and Required switches, and a Preview panel on the right, with Desktop and Mobile buttons, draws the form as a visitor will see it.
Changes go live the moment you save. Name is pinned as Always first; every other field can be moved, shown or made required, and the preview redraws as you change them.

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:

Table: Card, What you set there
CardWhat you set there
Form fieldsOrder, show and require each field. Name is tagged Always first.
RoutingWho gets new leads and who is told about them.
QuestionsExtra questions after the standard fields.
SharingWhether the form is live, its public link, and the embed code.
WordingThe title, the intro sentence and the thank-you message.
PreviewDesktop 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.

A form with no email and no mobile field throws submissions away

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…

Regenerating the link breaks every printed QR code, permanently

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.

An embed only loads on websites you have listed

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 lead form as a visitor sees it. A Tansi logo and an English, Español and Français switcher sit at the top, then the form title, an intro sentence, a note that fields marked with an asterisk are required, and the fields the administrator switched on: First name and Last name, Company name, Email, Mobile, Website, Address, Address 2, Country, City, Province or territory, Postal code and Message.
What a stranger sees. Name is always first and always required, because that is what turns a submission into a lead. The visitor can switch the form into French or Spanish.

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.

Bots are handled quietly

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

Section 10 · Pipeline · 10 min
Goal: Create a deal, fill in what a bid needs, and work the opportunity record's tabs.

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 Opportunities list. Columns for Submission deadline, Name, Account, Type, Amount with a currency code, Stage, Probability and Status, sorted with the soonest submission deadline first and overdue open deals in bold red.
A work queue, not an alphabet. The default sort is submission deadline, soonest first, with undated deals last.

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.

Submission deadlines are wall-clock, as typed

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.

Table: Section, What you fill in
SectionWhat you fill in
BasicsOpportunity 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.
SolicitationOpportunity type, RFP or solicitation number, solicitation website (a full validated URL), source, and the set-aside or procurement stream.
Value and stageBid value, currency, Status, Stage (required) and Probability.
DatesIssue date, questions deadline, Submission deadline (required), submission time and expected award date.
ScopeThe scope summary.
InternalOwner, 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

An opportunity record. Key figures for Bid value, Stage, Submission deadline with a countdown, Real margin and Submission ready. A Required details panel listing the fields that must be filled in, and a tab strip reading Activity, Pricing, Submission, Table, Documents and forms, Custom fields, Related, and Contract and billing.
The bid workspace. Bid value reads from Pricing once budget lines exist, and from the opportunity itself until then.

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.

Bid value has two sources, and it tells you which

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

Table: Tab, What is in it
TabWhat is in it
ActivitySub-tabs for Timeline, Tasks, Notes, Chat, Time and Schedule. Schedule is the Gantt of tasks, calls, meetings and billing milestones.
PricingSub-tabs for Budget lines, Vendor prices, Price sheet, Contractors and Bid costs.
SubmissionThe checklist, addenda, a Ready to submit? check, the recorded submission and Proposals.
TableTansi Sheets for this record.
Documents & formsThe folder explorer plus any attached Tansi Forms.
Custom fieldsA display with an Edit values toggle; changes save as you leave a field. A badge counts required fields still missing.
RelatedLinked records and automatic links.
Contract & billingThe contract summary, the billing schedule, and the Contracts and Invoices lists.
Old links still work

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

Section 11 · Pipeline · 6 min
Goal: Close a deal correctly and know what changes once it becomes a project.

A deal ends one of two ways, and Tansi asks for different things depending on which.

A won opportunity with bid value, stage, margin, submission readiness and deadline tiles, and the Award card with contract number, awarded value, type and date
A won opportunity. The Award card holds the contract number, awarded value, contract type and award date. Convert to Project sits at the top right.

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.

Converting makes the opportunity read-only

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.

Signature links die with the opportunity

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

Section 12 · Pipeline · 6 min
Goal: Move deals through stages on the board, by mouse or by keyboard, and read the summary honestly.
The Pipeline board. A summary strip showing Open deals, Total value, Weighted and Due this week. Below it one column per open stage in rotating accent colors, plus Won and Lost columns, with deal cards that can be dragged between them.
Weighted is value multiplied by stage probability. It is the number to forecast from; the plain total is the number to hope for.

/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 Pipeline board with summary figures, search, owner and sort filters, stage columns and the deadline legend underneath
The board. Shaded cards warn of a deadline that has passed or is close; the legend under the board explains the colors.
The Pipeline in table view with deal, account, stage, value, probability, weighted value, owner, submission deadline and expected award
Table view. The same deals as rows, with the submission deadline and expected award dates.

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.

The summary covers open deals only

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.
Board totals ignore currency

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

Section 13 · Pipeline · 4 min
Goal: Clear your follow-ups from one page and know which bucket a task will land in.
The My Activities page. Due buckets reading All open, Overdue in red, Due today in amber and Next 7 days, acting as filters. A table with Activity, Related to, Assigned by and Due columns.
Your follow-ups in one place. The buckets are filters — selecting Overdue narrows the table rather than opening a new page.

/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.

My Activities with All open, Overdue, Due today and Next 7 days tiles and a task table with Mark done on each row
My Activities. Your open follow-ups, with overdue ones flagged. Mark done closes a task from the list.

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.

Due dates are calendar days, not timestamps

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

Table: Column, What it shows
ColumnWhat it shows
ActivityAn icon, the subject, and a preview of the body.
Related toA link to the lead, contact, account, opportunity, project, quote or invoice it belongs to.
Assigned byWho gave you the task.
DueThe 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

Section 14 · Pipeline · 9 min
Goal: Convert a won opportunity into a project, keep the project's figures current, and track its milestones.

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.

  1. 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.
  2. Select Convert to Project.
  3. Check the Project name (it starts as the opportunity name, up to 200 characters).
  4. 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.
  5. Optionally pick a Project manager.
  6. 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.
  7. 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 copy is a snapshot

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:

Table: Tile, What it shows
TileWhat it shows
Contract valueThe copied contract value and its currency.
StatusThe project's current status.
% completeA whole number from 0 to 100.
Budget / actualThe 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 dateCalculated 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

Table: Field, Notes
FieldNotes
StatusChosen from the project status list. A new project starts at Planning.
% complete0 to 100.
BudgetThe estimated budget.
Actual cost to dateA manual figure, used when no costs are recorded against the project.
Invoiced to dateA manual figure, used when there are no project invoices.
Project managerOne person from the workspace.
Delivery teamSeveral people from the workspace.
Project notesFree text, up to 2,000 characters.
These fields wait for Save

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.

Deleting a milestone does not ask first

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

Table: Tab, What is different on a project
TabWhat is different on a project
ActivityTimeline, Tasks, Notes, Chat and Time. There is no Schedule sub-tab.
PricingTwo sub-tabs only: Budget and Quotes.
SubmissionProposals for the project.
TableYour project sheets. When there is a source opportunity, a switch shows its sheets instead, read-only.
Documents & formsThe project's documents and forms, plus the opportunity's forms listed read-only underneath.
Custom fieldsProject custom fields, edited in place, with the opportunity's custom field values shown read-only below.
RelatedLinked records, as on any CRM record.
Contract & billingContracts and Invoices.
Link an account before you bill

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

Section 15 · Working on a record · 11 min
Goal: Use the timeline, notes, documents, Table view and client portal that appear on every record.

Accounts, contacts, leads, opportunities and projects share a set of surfaces. Learn them once and they work the same everywhere.

The activity timeline

The activity timeline on a CRM record. A composer headed Log an activity with chips for Email, SMS, Call, Log call, Meeting, Task, Track time and More, a note box beneath it, and a dated feed grouped by day with filter chips above it.
The same timeline appears on every record. Notes written on a linked record show up here marked as a shared note.

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.

A dropped connection does not lose a note

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.

Delete removes a shared note everywhere; Unlink does not

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 tab on an opportunity. Sheet tabs along the top read Bid response tracker, Subcontractor quotes and Sheet 3, above a toolbar, a spreadsheet-style grid of rows and columns, and a line of keyboard hints.
Tabs are yours until you share them. Adding a column is not — a new column appears on every Tansi record of that type.

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.

Adding a column changes every record of that type

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.

A shared table link always expires

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 What the client can see dialog on an opportunity. A table with Kind, Item, Who and When columns lists one shared note. Below it a list headed Never shared, whatever the settings names stage changes, costs and internal notes, and ends with the sentence There is no configuration in which a client reads what your bid cost you.
Check before you invite. See what they see lists exactly what the client portal shows — and what it never will.
What a client portal never shows

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

Section 16 · Working on a record · 5 min
Goal: Recognize which timeline layout a record uses, filter it, and know which entries the client can see.

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.

The Activity tab with Log a call and the timer, sub-tabs, and the timeline toolbar with Email, SMS, Call, Meeting, Note, Task, Track time and Notify
The timeline. The toolbar logs each kind of activity; the chips filter the list by type.

Three layouts

Table: Where, Layout, What you get
WhereLayoutWhat you get
Accounts and leadsComposerA 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.
ContactsFeed onlyThe 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 projectsToolbarA 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.
Meet now and Schedule meeting fall back to a log entry

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

Section 17 · Working on a record · 5 min
Goal: Log any kind of activity, edit or delete it later, send an email or text from a record, and notify a teammate.

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.

Table: Field, When it shows, Notes
FieldWhen it showsNotes
TypeAlwaysThe activity types from your workspace picklist, including any custom types an administrator added.
DirectionCallsOutbound or Inbound.
SubjectAlwaysRequired. Save does nothing until it has text.
NotesAlwaysFree text.
Link to other leads/contactsNotes on a lead or contactThe 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)CallsPlaceholder e.g. Left voicemail, Connected — sending quote.
Due, ReminderTasksCalendar 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.

Table: Button, When it appears
ButtonWhen it appears
Open recordAlways. Jumps to the lead, contact, account, opportunity or project the entry belongs to.
Open the threadText messages, on pages that have a conversation tab.
Mark doneOpen tasks.
Pin / UnpinNotes. A pinned note shows in the record's Key notes panel.
Link to other leads/contactsNotes on a lead or contact.
Edit, DeleteNotes, 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.

  1. 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.
  2. Check the Title. It starts as Follow up: {record name}.
  3. Add a Message if the title is not enough.
  4. 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.

Notify is not a task

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

Section 18 · Working on a record · 6 min
Goal: Log a call properly, start or book a meeting from a record, send a booking link, and time your work on an opportunity.

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.

Table: Field, What to enter
FieldWhat to enter
DirectionOutbound (we called) or Inbound (they called).
WithA 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.
NotesWhat was said.
Also log the call's length as timeAdds 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 portalShares 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.

Table: Field, Detail
FieldDetail
TitleStarts as Meeting with {name}. Required.
Date, Start time, Time zoneRequired. The time is read in the zone you pick.
Duration15, 30 or 45 minutes, 1 hour, 1.5 hours or 2 hours.
Remind me, Reminder15 minutes, 30 minutes, 1 hour, 4 hours or 1 day before.
DescriptionSent to attendees with the invitation.
AttachmentsAdd 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

Section 19 · Working on a record · 4 min
Goal: Use the reach sheet to contact someone the way they prefer, record a preferred method, and work an SMS conversation.

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:

Table: Warning, What it means
WarningWhat it means
No contact details yetNo phone and no email. Add a phone number or email to start reaching {name}.
No usable contact detailsNo email and no number that receives texts — a phone call is the only way left.
Unsubscribed from notificationsThey 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 unavailableThey (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.

You can pin a channel that is not usable yet

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

Section 20 · Working on a record · 4 min
Goal: Manage a record's tasks and time entries, keep key notes in view, and read the opportunity 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.

The Tasks sub-tab with a task showing assignee, due date, priority, status and the Client can see switch
Tasks. Each task has an assignee, due date, priority and status. Client can see shares it on the client portal.
The Schedule sub-tab showing a Gantt chart with a meeting diamond, an overdue task bar, the bid due line and today
Schedule. Tasks run as bars, calls, meetings and milestones as diamonds, with the bid due date and today marked.

Add Task opens New Task with the record's workspace locked in and the task already linked to the record. The table shows:

Table: Column, What it shows
ColumnWhat it shows
TitleStruck through when done; the first 100 characters of the description below.
Assigned ToWho has it.
DueA chip — red when overdue, amber when due soon.
PriorityUrgent, High, Medium or Low.
StatusFor example In Progress, On Hold, Awaiting Approval, Completed or Cancelled.
ClientShown 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:

Table: Field, Notes
FieldNotes
WorkerRequired. The account's team plus the record owner. Names without a rate read — no rate set, and the dialog shows Standard rate: {rate}.
DateDefaults to today.
MinutesAt least 1. Starts at 60.
DescriptionUp to 300 characters.
Override rateLeave 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.

Time entries cannot be edited, only deleted

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

Section 21 · Working on a record · 4 min
Goal: Set up who works an account and at what rate, sync rates with a project, and read the account's billing ledger.

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.

Table: Column, What it shows
ColumnWhat it shows
WorkerThe person.
RoleTheir role on this account, or Not set with an Add role button.
Rate{amount}/h, or No rate set with a Set rate button.
NotesFree text, or No notes.
Row actionsEdit 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.

Table: Column, Notes
ColumnNotes
Date, WorkerWhen and who.
SourceManual for typed-in entries, Meeting for time from a billable meeting, and so on. Meeting entries are read-only here.
DescriptionWhat was done.
Actual, BilledMinutes worked and minutes charged.
Rate, AmountOr a warning: Missing rate — set a worker rate to bill this entry.
Row actionsDelete, 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.

Fix rates before the month closes

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

Section 22 · Working on a record · 5 min
Goal: Fill in custom fields, link related records, attach forms for the owner to complete, and read the events and campaigns 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.

Some field types have no input in the edit form

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.

  1. Select Link a record.
  2. Choose the Record type: Project, Opportunity, Account or Contract — and Support ticket when your workspace has Support.
  3. Type in Search and press Enter (or select the search icon). Until you search, the dialog says Search to find records to link.
  4. 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.

  1. Select Attach form. The dialog says It flows to the record's owner to complete.
  2. Pick the Form.
  3. Turn on Required and, if a manager must sign off, Requires approval.
  4. 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

Section 23 · Working on a record · 4 min
Goal: Turn the client portal on safely, invite the right people with the right role, and control exactly which items they see.

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.).

Table: Role, What they can do
RoleWhat they can do
ViewerRead what is shared.
ContributorRead, and also post notes, upload files, raise requests and ask for meetings.
SignerEverything 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.

Invite people, not inboxes

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

Table: Where, The control
WhereThe control
Timeline entries, notes, quotes, invoicesA chip: Internal only or Shared with client. Select it to flip.
New notesA Visible to client switch beside Add note. It turns itself off after each note, so sharing is always a deliberate act.
DocumentsA Client can see switch. Private documents and receipts can never be shared.
TasksA Client can see switch.
Calls logged on an opportunityThe 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

Section 24 · Working on a record · 4 min
Goal: Tell the list Table view apart from a record's Sheets, use saved tabs and columns safely, and share rows outside the organization.

Two different spreadsheet-style tools carry the word Table. They do different jobs.

Table: , List Table view, A record's Table tab
List Table viewA record's Table tab
WhereThe Table layout of the Leads, Contacts and Opportunities listsInside an opportunity or a project
RowsOne row per lead, contact or opportunityRows you create — a bid tracker, a risk register, meeting minutes
ColumnsRecord fields, plus custom fieldsFields you design, sheet by sheet
SharingRead-only row shares to people outside TansiStays 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

  1. Tick the rows to share. Share rows stays disabled until at least one is ticked.
  2. Enter the recipient's name (required), Email (required), an optional Title and an optional Message (up to 500 characters).
  3. Pick when the link expires: 7, 14, 30 or 90 days. It starts at 30.
  4. Untick any columns they should not see. Every offered column starts ticked; internal columns such as owner and notes are never offered.
  5. Confirm. The dialog then shows the link with a copy button — copy it now.
Copy the link when you create it

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

Section 25 · Events · 7 min
Goal: Create an event, build its agenda, and know which header action does what.

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 with columns for Event, Starts, Status, Registered (shown against capacity) and Revenue, and buttons for New event, Export and Spaces and calendar.
Every event in one line each. Registered against Capacity is the number to watch before you publish more passes.

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

An event record. Header buttons for View public page, Check-in, Edit and Publish, with a More actions menu holding Close sales. Stat tiles for Registered, Checked in, Net revenue and Waitlist, and a tab strip reading Overview, Agenda, Passes and promo codes, Registrations, Orders and Feedback.
One record runs the whole event. The public registration page link sits on the Overview tab with a Copy link button beside it.

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.

Cancelling and deleting an event are not the same thing, and neither is gentle

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

Section 26 · Events · 9 min
Goal: Set up what people can buy, manage who is coming, and handle the awkward cases.
The Passes and promo codes tab. A Passes table with Name, Price, Sold, Visibility and Sales window columns, and a Promo codes table with Code, Discount, Used, Valid until and Unlocks code-only passes columns.
Visibility controls who can buy. A code-only pass stays invisible until someone enters a promo code that unlocks it.

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.

Table: Visibility, Who can buy it
VisibilityWho can buy it
PublicAnyone on the registration page.
Hidden — staff onlyNobody on the public page. You add these attendees yourself.
Code only — unlocked by a promo codeInvisible 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

The Registrations tab. A search box, a status filter and buttons for Add attendee, Import and Export. A table with Name, Email, Organization, Pass, Status, Checked in, Badge printed and CRM columns, with Duplicate email and Needs review flags on some rows.
The attendee list, with its own warnings. Flags for duplicate emails and rows that need review appear before the event, not after it.

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

Table: Action, What it does
ActionWhat it does
Check in / Undo check-inMarks arrival without opening the check-in page.
Open in CRMJumps to the matching CRM record.
Resend ticketEmails 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 spotUsed on a waitlisted person. When the event is full the dialog asks whether to go over capacity.
Reissue portal linkEmails 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.
Cancelling one person on an unpaid order cancels the whole 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

Section 27 · Events · 9 min
Goal: Run B2B matchmaking and sell sponsorships, with the consent rules that go with badge scanning.

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

Table: Sub-tab, What you do there
Sub-tabWhat you do there
Attendee typesName 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 & tablesGenerate 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.
ApprovalsThe 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.
MeetingsA grid of When, Requested by, With, Status, Mode, Table, Rating with schedule, set-table, no-show and cancel actions, and an export.
Changing a pass's attendee type clears networking profiles

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

Attendees choose whether exhibitors see their details, and can change their mind

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

Section 28 · Events · 8 min
Goal: Run the door on event day and book the rooms your sessions need.
The event check-in page. The event name with a counter reading 0 of 0 checked in, a Scan tickets with camera button, a Ticket code box with a Check in button, a Find by name, email or organization search and a Register a walk-up button.
Built for a phone at the door. When the camera will not start, the ticket code box does the same job.

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.

Three things about badges that are decided elsewhere

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

The Spaces and calendar page on its Calendar tab. A day and week grid in a chosen time zone with one row per space, and a legend reading Draft event, Space hold and Overlaps another booking.
Rooms are shared across events. An overlap is flagged, not forbidden — the conflict list offers Book anyway.

/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.

Deactivate a space rather than deleting 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

Section 29 · Events · 10 min
Goal: Follow the attendee's path from the public page to the portal, and run feedback and recordings afterward.

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.

Table: Tab, What the attendee does there
TabWhat the attendee does there
TicketTheir pass, ticket code and QR code — Show this QR code at check-in — with Download ticket (PDF) and Add to calendar.
AgendaThe sessions, with Join links for online ones.
My meetingsRequests 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.
DirectorySearch and filter other attendees, and Request meeting with a slot picker and a choice of in person or online.
ExhibitorsThe sponsor wall, and their own sharing consent switch.
ProfileTheir networking profile, with Show my profile in the attendee directory and an approval state.
FeedbackThe post-event survey.
RecordingsAn 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…

Publishing recordings as a course creates a draft, in the event's workspace

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

Section 30 · Events · 9 min
Goal: Create an event, fill in every setting with intent, and get it published without a refusal.

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.

A draft event with Edit, Publish and the more-actions menu, the event tabs and the Registered, Checked in, Net revenue and Waitlist tiles
A draft event. Until you publish, the header shows only Edit, Publish and the more-actions menu.

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.

Table: Field, What to know
FieldWhat to know
Event nameRequired, up to 200 characters. Shown on the public page, tickets and badges.
Short descriptionUp to 500 characters. Shown on the public event page as the event's description.
Start date, Start time, End date, End timeRequired. A new event starts 30 days from today, 9:00 to 17:00. The end must be after the start.
Time zoneEvery 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.
FormatIn person, Virtual or Hybrid. Choosing Virtual hides the venue fields and clears them when you save.
Venue name, Address, Unit / suite, City, Province, Postal codeShown on the public page and in calendar invites.
CapacityThe 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 outWhen on, a sold-out event offers Join the waitlist instead of closing the door.
Marketing opt-in textIf 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.

Rewording a question keeps its answers

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

  1. Add at least one pass on Passes & promo codes. Publishing without one is refused with Add at least one pass before publishing.
  2. Check the start is still in the future. A past start is refused with The event start is in the past.
  3. Add sessions on Agenda if people need to see a program or you will check in per session.
  4. 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

Table: Status, What it means, How you get there
StatusWhat it meansHow you get there
DraftBeing built. The public page answers Event not found.Every new or duplicated event starts here.
PublishedOpen for registration.Publish from Draft or from Sales closed.
Sales closedNo new registrations. Existing tickets stay valid and check-in still works.More actions › Close sales on a published event.
CompletedThe event is over.Set by Tansi, not by a button.
CancelledCalled 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.

A time change emails everyone

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

Section 31 · Events · 8 min
Goal: Build the program, book rooms without double-booking by accident, and reserve setup time.

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 Agenda tab with the sessions table and the Space holds table, each with Export and Add buttons
Agenda. Sessions above, space holds for setup and teardown below.
Spaces and calendar in Day view with a space row, the time zone and the legend for draft events, holds and overlaps
Spaces & calendar. Every booking across your events, by space and time.

The sessions table

Table: Column, What it shows
ColumnWhat it shows
TimeThe session's start and end in the event's time zone.
SessionThe title.
SpaceThe 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.
TrackYour grouping, such as Main stage or Workshops.
DeliveryIn person, Virtual or Hybrid.
RecordingWhere 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

  1. Select Add session. The times start on the event's first day.
  2. Type the Session title (required, up to 200 characters) and a Description.
  3. Set the Start date, Start time, End date and End time.
  4. Pick a Space, or leave No space. The picker appears once your workspace has spaces; without any, a Room text box appears instead.
  5. Fill in Track and choose the Delivery.
  6. 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.
  7. Optionally paste a Recording link (optional) — a YouTube, Vimeo or other https link used when the session has no Tansi recording.
  8. 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.

When an overlap is right

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.

  1. On Agenda, scroll to Space holds and select Add hold.
  2. Choose the Space.
  3. Type a Label, or select the Setup or Teardown chip to fill it.
  4. Adjust the times. A new hold starts as the two hours before the event begins. Times are in the event's time zone.
  5. 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

Section 32 · Events · 10 min
Goal: Find anyone on the list, add people by hand or in bulk, and handle waitlists, transfers and cancellations correctly.

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.

Table: Column, What it tells you
ColumnWhat it tells you
NameWith a Duplicate email chip when another registration uses the same address, and a Needs review chip when the order is flagged.
Email, Organization, PassAs entered.
StatusAwaiting payment, Confirmed, Waitlisted, Cancelled or Refunded.
Checked inThe time they were checked in, or a Check in button for a confirmed person who has not arrived.
Badge printedWhen their badge was last printed, or a dash.
CRMA 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

  1. Select Import, then Download template if you need the column layout: FirstName, LastName, Email, Phone, Organization.
  2. Select Spreadsheet (.csv or .xlsx) and pick your file. Tansi shows how many rows it found.
  3. Choose the one Pass every row will get.
  4. Decide on Email tickets. It is off by default here — the opposite of Add attendee.
  5. 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.

Table: Action, Available when, What happens
ActionAvailable whenWhat happens
Resend ticketConfirmed 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 linkNot 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 spotWaitlisted 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-inChecked 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.

Canceling does not refund unless you tick the box

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

Table: Status, Meaning
StatusMeaning
PendingWaiting 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.
PaidPaid in full.
FreeNo payment needed.
Partly refundedSome registrations were refunded.
RefundedFully refunded.
CancelledCanceled without payment.
ExpiredThe payment hold ran out.

Running the door on event day

Section 33 · Events · 7 min
Goal: Set up check-in stations, handle every result the scanner gives, and print badges at the desk.

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

  1. Sign in on each device and open the event's Check-in page.
  2. If the event has sessions, set Session to Whole event at the main door, or to one session at a breakout room door.
  3. Select Scan tickets with camera and allow camera access when the browser asks.
  4. Do a test scan with a staff ticket, then Undo check-in it from the Registrations tab.
  5. 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

Table: Banner, What to do
BannerWhat 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 eventNo 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 sessionTheir ticket is real but this session is not on their pass.
Ticket not foundCheck 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.

A volunteer-friendly desk

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

Section 34 · Events · 11 min
Goal: Configure B2B meetings so the right attendees can book each other, then run the meeting grid on the day.

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 Networking tab with request and meeting tiles, matchmaking settings and the attendee types, slots, approvals and meetings sub-tabs
Networking. Turn on B2B matchmaking, set limits and request windows, then define who can meet whom.

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.

Table: Field, What it does
FieldWhat it does
NameRequired, up to 100 characters, such as Buyer or Supplier.
DescriptionUp to 300 characters, for your team.
Staff approve profiles before they appear in the directoryWhen ticked, a profile waits in Approvals before others can see it. When not, it goes live on save.
Badge colourThe band color on printed badges for this type. It wins over the pass color.
May send meeting requests toOne 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 questionsWhat 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.

Table: Row action, When it shows
Row actionWhen it shows
Set tableAccepted, in-person meetings. Both attendees are emailed.
{name} didn't attend / Neither attendedAccepted or held meetings whose slot has started.
Cancel meetingRequested 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.

The networking type override opens on the pass type

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

Section 35 · Events · 11 min
Goal: Sell sponsorship packages through the CRM, follow each sponsor's status, and hand sponsors their passes and scanners.

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.

The Sponsors tab with sponsor, committed value, paid and leads scanned tiles, the lead scanning switch, packages and sponsors tables
Sponsors. Packages to sell, the sponsors who bought them, and whether booth reps may scan badges.

Packages first

Add sponsor stays disabled until at least one package exists. Select Add package:

Table: Field, What to know
FieldWhat to know
Name, DescriptionName is required (150 characters), such as Gold or Exhibitor booth.
PriceUsed for the draft quote.
How many can be soldEmpty 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 scanner0 to 50 scanner links per sponsor.
Complimentary passes0 to 200 free tickets per sponsor.
Pass used for complimentary passesWhich 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 pageLarge, Medium (the default), Small or Name only.
Display orderSorts packages on the event page.

Adding a sponsor

  1. Select Add sponsor and pick the Package.
  2. Type at least two letters of the company in CRM account and pick it. The account must already exist in the event's workspace.
  3. Pick a Contact, or No contact.
  4. 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.
  5. 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}.

Canceling a sponsor leaves their free tickets valid

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.

Your lead view shows emails the exhibitor cannot see

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

Section 36 · Events · 6 min
Goal: Brief a sponsor's booth staff on scanning badges, rating leads and downloading them, within the consent rules.

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.

Consent is read live

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

Section 37 · Events · 9 min
Goal: Answer the common attendee requests — lost links, unpaid orders, refunds and portal access — knowing exactly what they see.

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.

Table: Button, When the buyer sees it
ButtonWhen the buyer sees it
Complete paymentThe order is unpaid, its seat hold has not run out, and the event has not started.
Cancel this order / Leave the waitlistThe order is unpaid (or entirely waitlisted) and the event has not started. It cancels everyone on the order at once.
Download ticketOn each confirmed attendee.
Open event portalOnly on the buyer's own registration — the one with the buyer's email.
Resend portal link to attendeeOn everyone else's live registration. It emails that attendee's own address, never the buyer.
CancelOn 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 buyer cannot open a colleague's portal

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.

Table: Tab, Appears when
TabAppears when
TicketAlways. Awaiting payment and waitlisted attendees see a message instead of a QR code.
AgendaThe registration is confirmed. It lists only sessions their pass includes.
FeedbackConfirmed, the event has ended, the survey is on and they are in its audience.
RecordingsConfirmed, the event has ended, and at least one recording their pass allows is shared.
ExhibitorsConfirmed and the sponsors feature has something to show.
My meetings, DirectoryTheir pass maps to an attendee type and matchmaking is on.
ProfileConfirmed 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

Table: The attendee says, What you do
The attendee saysWhat you do
I lost my ticketResend ticket on their row, or tell them the ticket is on their portal's Ticket tab.
My portal link doesn't workThey 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 payA 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 meTransfer… the ticket. The new person gets a new QR code and portal link.
I want a refund but it's past the deadlineGuests 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 spinningThe 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

Section 38 · Events · 9 min
Goal: Set up the follow-up survey, share recordings with attendees, read the results and turn recordings into 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.

The Feedback tab with survey settings, rating and recommend questions, timing, and response, rating and net promoter tiles
Feedback. Choose the questions and when the survey goes out; results build up underneath.

Survey settings

Table: Setting, What it does
SettingWhat it does
Send a feedback survey after the eventTurns the survey on.
Survey questionsYour 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 toChecked-in attendees or Everyone with a confirmed registration. This also decides who may answer.
Hours after the event ends0 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.

Pick the audience on purpose

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

Section 39 · Events · 8 min
Goal: Follow a complete, realistic setup for four common kinds of event, start to finish.

These walk-throughs string the earlier sections together. Each lists only the steps that kind of event needs.

A paid trade show with exhibitors

  1. Create the event with a capacity, a 13% tax rate and a 72-hour refund cutoff.
  2. Add passes: Early bird (public, sales end a month out), General (public), Exhibitor staff (hidden, $0), Sponsor comp (hidden, $0).
  3. 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.
  4. Build sponsorship packages, add sponsors from CRM accounts, and send each quote from its opportunity.
  5. Switch on Let booth reps scan attendee badges so the registration form asks for sharing consent.
  6. Publish. Watch the Overview tile for registrations and the warning list for orders that need attention.
  7. Print badges on Avery 5392 the day before; print latecomers with Only badges not printed yet.
  8. After the show, share recordings and send the survey to checked-in attendees.

A free internal training day

  1. Create the event with no tax and a 0-hour refund cutoff (nothing to refund).
  2. Add one public $0 pass with a quantity equal to the room size.
  3. Import the staff list with the pass and Email tickets switched on.
  4. Add sessions per room and check in per session to record attendance for each module.
  5. 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.

  1. Create a free event with a waitlist, and a capacity matching the hall.
  2. Add registration questions such as preferred language and accessibility needs.
  3. Book the hall and the two side rooms as spaces, with a Setup hold the evening before.
  4. When it fills, offer waitlist spots as cancellations come in.
  5. Use walk-up registration at the door for people who did not sign up.

A construction site safety orientation

  1. Duplicate last month's orientation and change the dates.
  2. Keep one hidden pass and add every new hire yourself with Add attendee, so nobody can sign up from the public page.
  3. Check people into each session — classroom, then yard walk — so the record shows who completed both.
  4. Publish the recording of the classroom part as a course for crews who start mid-month.
Hidden passes make private events

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

Section 40 · Procurement · 7 min
Goal: Keep a usable register of the tender sites you bid on, and understand what a vendor sees when you ask them for prices.
The Procurement Portals page in rows layout. Columns for Portal with a logo, name host and place, Who buys there, Covers, Keywords and Sign-in showing Saved or None. A caption states that credentials are never shown in this table.
The tender sites you bid on. The search box matches the name, the address, the place, the description and the keywords at once.

/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

What the PIN does, and what it does not do

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?:

Table: Choice, What it means
ChoiceWhat it means
Just this onceYou will be asked again next time.
Until I sign outAnybody using this computer while you are signed in can reveal passwords without the PIN.
30 days on this deviceConvenient, 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

The vendor portal sign-in page, headed Sign in to see your price requests. A sentence explains that the vendor enters the address their price requests were sent to and is emailed a sign-in link, with no password needed. Below it an Email address box and an Email me a link button.
No password needed. The vendor gets a one-time link that works for 20 minutes, then lands on Your price requests, grouped by opportunity.

/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.

Vendor sign-in links work once, for twenty 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

Section 41 · Bids and pricing · 6 min
Goal: Find your way around an opportunity's Pricing tab and build a budget of nested lines that prices the work.

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.

The Pricing tab on Budget lines with nested lines, who does it, quantity, unit, unit cost and line cost, and the direct cost total
Budget lines. The five Pricing sections run across the top. Lines nest under sections, and Bid costs come in as their own line.
Table: Sub-tab, What it does, Chip
Sub-tabWhat it doesChip
Budget linesThe breakdown of the work: what is delivered, by whom, at what cost.3 to price, Not priced or Done
Vendor pricesRequests to suppliers and subcontractors for prices.2 need vendor prices, 4 prices in or Chosen
Price sheetWhat the client sees, saved as numbered revisions; and the quotes list.1 to fix, Changed since Rev 2 or Rev 2
ContractorsYour contractor register and who is in this budget.
Bid costsWhat 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.

Table: Column, What it holds
ColumnWhat it holds
LineThe 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 itOur team, Subcontract or Supply.
Qty, UnitThe quantity and its unit.
Qty 2 (optional), Unit 2A second quantity, for prices such as 3 technicians × 5 days.
Unit cost, Line costLine cost is quantity × second quantity × unit cost.
ActionsMove 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:

Table: Field, Notes
FieldNotes
NameUp to 200 characters. Placeholder Mechanical rough-in.
BasisEstimated, Budgetary, Quoted or Committed — how firm the number is.
DeliverySelf-perform, Subcontract or Supply.
ContractorRequired for a subcontract line; otherwise None — we do it.
Quantity, Unit, Qty 2, Unit 2Units come from CRM Settings. A unit no longer in the list shows as {unit} (not in the list).
CostThe unit cost. A live line shows the sum, such as 40 h × 85.00 = 3,400.00.
Starts, EndsDates for the timeline. The end cannot be before the start.
NotesUp 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.

Only the lowest lines carry prices

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

Section 42 · Bids and pricing · 6 min
Goal: Record what a bid costs to chase, keep the contractor register current, and read how Tansi builds the price you should bid.

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.

The Contractors sub-tab with a contractor showing type, demographic, prequalification, insurance and WCB dates and warnings
Contractors. Warnings flag insurance or WCB that lapses before the work closes.
The Bid costs sub-tab with bid budget, expenses, staff time and left in budget tiles, a costs table and the breakdown by type and cost centre
Bid costs. What chasing the bid costs you, with receipts flagged and the total carried to Budget lines.

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.

Costs are internal, always

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.

Table: Column, Notes
ColumnNotes
Date, TypeTypes: Labour, Subcontractor, Printing & binding, Courier & shipping, Travel, Bid security, Software & data, Other.
DescriptionWith Paid to {supplier} underneath.
Cost centreAn expense account from your chart of accounts.
Amount, Tax, TotalTax shows how much comes back, such as 6.50 back.
ReceiptReceipt or No receipt.
MenuEdit, 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

  1. Select Add a cost.
  2. Set the Date (today or earlier), Type, Cost centre, Paid to / supplier and Amount before tax.
  3. Add a Description, and tick Recoverable from the client if we win if the contract lets you claim it back.
  4. 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.
  5. Choose a receipt or supplier invoice (PDF, PNG or JPG). It uploads when you save and is internal always.
  6. 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.

Table: Column, Notes
ColumnNotes
ContractorName, main contact and any risk flags.
TypeSubcontractor, Trade contractor, Consultant, Supplier or Staffing agency.
Cost centreTheir default expense account.
DemographicCertified classifications such as Indigenous-owned, Women-owned or Local / regional. A lapsed certification is struck through.
PrequalNot started, In progress, Approved, Approved with conditions or Rejected.
Insurance / WCBExpiry dates.
In the budgetTheir 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:

Table: Row, How it is worked out
RowHow it is worked out
Our own teamSelf-perform lines, at your own rates.
Subcontract and supplySubcontract and supply lines.
Bid costsAdded here only when charged to the client; otherwise marked Not charged.
Direct costThe sum of the above.
OverheadA percentage of direct cost — office, insurance, bonding, IT.
ContingencyA percentage on direct plus overhead.
Cost to deliver and winEverything so far.
MarginA percentage on cost to deliver.
What we should bidThe 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

Section 43 · Bids and pricing · 6 min
Goal: Turn the budget into client prices, save numbered revisions, preview the document, and send a revision as 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.

The Price sheet sub-tab with the lines to include, how the client sees the price, client prices and the bid build-up panel
Price sheet. Choose the lines, how prices show, and the client prices. The bid build-up on the right shows how the total is reached.

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.
Table: Revision status, Meaning
Revision statusMeaning
Draft · currentThe latest revision, matching the sheet.
Draft · 2 changes sinceThe latest revision, but the sheet has moved on.
ReplacedAn older revision. It cannot be sent as a quote.
Submitted · lockedRecorded 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.

Table: Option, Choices
OptionChoices
LayoutClassic (letterhead with a colored rule), Modern (colored banner, large total), Government price form (black and white boxes, numbered rows, bidder block), One-page summary.
ColourTansi teal, Navy, Charcoal, Forest or Plum. The government form always prints in black and white.
ShowLogo; GST line and total with tax; Optional items; Page numbers.
Text sizeNormal or Large.
WordingCover 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.
Tansi does not write your terms

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

  1. Select Send as quote on the current revision.
  2. Tick recipients under To — the account's contacts with an email — and add others in Other email addresses, separated by commas.
  3. Check the Subject (Quote for {opportunity} (Revision 2)) and the Message. The link to view and accept the quote is added after your message.
  4. Choose a Format, or Edit options and preview.
  5. Under Attachments, add other price sheets or documents. The quote PDF is always attached.
  6. 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

Section 44 · Bids and pricing · 6 min
Goal: Send suppliers and subcontractors a price request, follow their replies, and choose the prices that go into your budget.

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.

The Vendor prices sub-tab with New price request and the empty request list
Vendor prices. Send vendors a form with the items to price, 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.

Table: Step, What you fill in
StepWhat you fill in
What to priceRequest 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.
VendorsSend 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 pageWhat 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.
EmailStart 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

Table: Option, What it means
OptionWhat 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 emailCopies 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.
The PIN is shown once

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:

Table: Column, Notes
ColumnNotes
Vendor, SourceSource is Vendor or Contractor.
StatusSent, Opened, Prices in, Declined or Send failed.
Total, Missing pricesMissing counts the items they left unpriced.
Chosen, FilesWhether their prices were used; how many files they sent.
Vendor linkRevoke link — {vendor} won't be able to open the request or send prices anymore. This can't be undone.
Opened documentsNot 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

Section 45 · Bids and pricing · 4 min
Goal: Control who can open your bid documents and for how long, and understand the vendor side of a price request.

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}.

Table: Setting, What it does
SettingWhat it does
Access for everyoneThe default access level for the request's documents.
PINAdd 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 endsLeave blank to keep access until you take it back.
Documents tablePer document: its section, its own access (Same as the request or a different level), and its own PIN or The request's PIN.
Vendors tablePer 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.

View-only is a deterrent, not a lock

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

Section 46 · Bids and pricing · 5 min
Goal: Build the submission checklist the RFP asks for, track addenda, check readiness, and record the submission so the price locks.

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.

The Submission tab with submission parts, addenda, the Ready to submit checklist and the proposals list
Submission. The checklist on the right must be green before you record the submission.

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.

Table: Column, Notes
ColumnNotes
#The part's number, such as 2.3.
PartName, required marker, and a page limit such as 10-page limit.
OwnerWho prepares it. Automatic for the part that fills in from Pricing; Someone outside this workspace when the person has left.
DueMarked when overdue.
DocumentsDownload links. The price sheet appears as Made from Pricing.
StatusNot started, In progress, Ready for review or Approved.
ActionsEdit, 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.

The financial part looks after itself

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?

Table: Check, Passes when
CheckPasses when
Required detailsThe opportunity's required fields are filled.
Price sheetIts current revision has no changes or problems since it was made.
Required parts approvedEvery required part is Approved.
Addenda acknowledgedEvery addendum is acknowledged.
Price checked after addendaEach price-affecting addendum has a later revision or a no-change tick.
Sent by the deadlineThe 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

  1. Select Record the submission. The dialog says This locks the checklist and the price sheet at Revision 3.
  2. Choose How was it sent? — Online portal, Email, Courier, Hand delivered or Other — and add Details (optional) such as the portal's name.
  3. Enter the Date and time sent (not in the future).
  4. Enter the Confirmation number from the portal receipt or email reply, or type none.
  5. Add Notes and upload the Receipt (optional) — it is saved to Documents as an internal file.
  6. If items are still open, tick Record it anyway: it was sent like this.
  7. 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.

Recording locks the price sheet

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

Section 47 · Paperwork and money · 9 min
Goal: Send a document for signature or payment, and know exactly what the recipient sees.

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

The Signers dialog for a draft contract, opened from the Contracts table on an opportunity's Contract and billing tab. It shows the contract number and title, a count reading 0 of 1 signed, and a table with Name, Email, Order and Status columns, a Pending chip and a Copy link button.
Track signatures from your side. Copy link gives you a signer's personal signing page. Signing order is enforced: a later party is told it is not their turn yet.

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.

Signing order is enforced

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.

These are lightweight electronic records, not qualified e-signatures

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

Section 48 · Paperwork and money · 5 min
Goal: Create, edit, send and track quotes and invoices from an opportunity or project, and know which actions cannot be undone.

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

Table: Column, Notes
ColumnNotes
NumberWith the From the opportunity chip on a project's inherited quotes.
StatusDraft, Awaiting response (sent), Accepted, Declined or Cancelled.
Total, IssuedThe quote total and issue date.
ExpiresAdds (expired) when the date has passed and the quote is still Draft or Awaiting response.
Created byWho made it.
ClientInternal 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:

Table: Action, What it does
ActionWhat it does
EditOpens the quote editor. Missing on quotes sent from a price sheet revision — they keep that revision's lines.
SendAsks 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 SentDrafts only. Makes the public link live for a response without emailing — for a quote you delivered some other way.
DeleteRemoves the quote immediately. There is no confirmation.
Create InvoiceMakes 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 QuoteSets the status to Cancelled.
Create DuplicateCopies 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.

Lines with no description are dropped when you save

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.

Attachments have a size budget

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

Section 49 · Paperwork and money · 3 min
Goal: Prepare a contract or proposal with its signers, send it in the right order, and follow who has signed.

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.

Table: Button, When
ButtonWhen
EditDraft only.
SendDraft only. Emails the signers whose turn it is.
VoidAny status except Signed.
DeleteAlways, and immediately — no confirmation.
SignersOpens the signer status dialog.
PDFDownloads 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

Table: Field, Notes
FieldNotes
TitleRequired — Title is required.
SignersName, Email and Order per row. Add signer gives the new row the next order number. The last row cannot be removed.
Expiry dateWhen the contract lapses.
Contract bodyThe 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.

Edit before you send

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

Section 50 · Paperwork and money · 4 min
Goal: Read the contract summary and plan payment milestones that turn into invoices at the right time.

An opportunity's Contract & billing tab opens with two panels: Contract and Billing schedule. Below them sit the Contracts and Invoices lists.

The Contract and billing tab with the contract value and number, the billing schedule and the contracts list with Edit, Void, Delete, Send, Signers and PDF
Contract & billing. The contract summary, payment milestones and every contract with its actions.

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:

Table: Source line, Meaning
Source lineMeaning
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.

Table: Column, Notes
ColumnNotes
MilestoneIts name.
ShareA percentage such as 30 %, or Fixed.
Amount (before tax)Worked out from the share, or the fixed amount.
DueThe due date.
StatusPlanned, Ready to invoice, Overdue, Invoice drafted, Invoice sent or Paid.
InvoiceThe invoice number, a Create invoice button, or Not invoiced.
ActionsEdit, 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

  1. Select Add milestone and name it (up to 200 characters), such as Mobilization or Final acceptance.
  2. 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.
  3. Enter the Share (%) — the dialog previews it, That's $12,000.00 before tax. — or the Amount before tax.
  4. Set the Due date and the Status: Planned or Ready to invoice.
  5. Optionally tie it to a Price sheet revision and add Notes (shown on the invoice).
  6. 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.

An invoiced milestone is frozen

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

Section 51 · Insights · 8 min
Goal: Read the sales reports, choose the right period, and know which numbers are incomplete.
The Sales reports page. A reporting period control grouped into Year, Half, Quarter, Rolling and Custom, headline figures for Open pipeline, Weighted, Won this period, Win rate, Average sales cycle and Overdue tasks, and charts each with a View as Chart or Table switch.
Every chart has a table behind it. The switch matters for screen readers and for anyone who wants the numbers rather than the shape.

/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

Table: Figure, What it counts
FigureWhat it counts
Open pipelineOpen deal value, with the deal count and the as-at date.
WeightedThe weighted total, shown as a percentage of open value.
Won this periodWon value and deal count.
Win rateThe ratio, with the won and lost counts beside it.
Avg sales cycleDays, noted as lower is better.
Overdue tasksOpen 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

Money totals leave out other currencies

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

Section 52 · Administration · 12 min
Goal: Configure the stages, fields, picklists and templates the rest of the CRM depends on, without breaking anybody's history.
Admin & manager note

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.

The CRM settings page. A scope bar at the top stating that changes apply to this workspace, and a left navigation listing Chart of accounts, Units of measure, Pricing templates, Submission templates, Quote and price sheet formats, Vendor request templates, Vendors and contractors, Custom fields, Pipeline stages, Picklists, Tags, Leads and Calling.
Read the scope bar first. It tells you whether you are changing one workspace or the defaults every workspace inherits.

/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.

Editing global defaults changes other people's CRM

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

Table: Panel, What it configures
PanelWhat it configures
Chart of accountsThe account codes quote, invoice and cost lines are coded against. The same panel is also its own page — see the next section.
Units of measureThe units in every unit list, including Unit and Unit 2 on budget lines.
Pricing templatesReusable sets of budget lines.
Submission templatesReusable lists of submission sections and parts.
Quote and price sheet formatsLetterhead, layout, style, accent and terms.
Vendor request templatesThe emails and cover pages for vendor price requests.
Vendors and contractorsThe register you can send price requests to.
Custom fieldsExtra fields per record type.
Pipeline stagesThe pipeline board's columns and their probabilities. This is the panel the page opens on.
PicklistsThe choices behind each dropdown.
TagsRename, recolor and delete the tags already in use.
LeadsThe going-cold threshold.
CallingSoftphone 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 workspace must claim its stages before it can edit them

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.

A custom field's key is permanent from the moment you create it

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.

Table: Item, Fields
ItemFields
QueueName (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.
ExtensionExtension (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.
Deleting a document format does not change quotes already sent

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

Table: Dialog, Field limits and rules
DialogField limits and rules
New stage / Edit stageName 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 fieldLabel 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 valueLabel 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

Section 53 · Administration · 4 min
Goal: Set up the account codes that quote, invoice and cost lines are coded against.
Admin & manager note

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.

The Chart of accounts page. A scope banner naming the workspace being edited, an Add account button, and a table with Code, Name, Type showing Income, Expense, Asset, Liability or Equity, Status and Actions columns, with usage shown as a count of lines.
Account codes belong to one workspace. Nothing can be added or changed until a workspace is picked.

/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.

Account codes belong to one workspace

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

Table: Field, What it is
FieldWhat it is
CodeThe number your bookkeeping uses, like 4000. Up to 20 characters, and unique in the workspace.
TypeIncome, Expense, Asset, Liability or Equity. Decides which reports the account rolls up into.
NameWhat appears on a quote or invoice line.
ActiveInactive 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:

Table: Field, Help shown
FieldHelp shown
CodeThe number your bookkeeping uses, like 4000. Up to 20 characters. Codes are unique — Code {code} is already used by “{name}”.
TypeDecides which reports the account rolls up into.
NameWhat appears on a quote or invoice line.
ActiveInactive 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

Section 54 · Administration · 6 min
Goal: Remove a stage, field, picklist value, tag, unit or account code without damaging the records that use it.
Admin & manager note

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.

CRM settings on Pipeline stages with the stage table showing order, name, probability, type and status
CRM settings. Every settings page belongs to one workspace. Stages show their probability and whether they count as open, won or lost.

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:

Table: Setting, Why it cannot be deleted, What to do instead
SettingWhy it cannot be deletedWhat to do instead
Pipeline stageIt 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 fieldIt holds data on at least one record.Edit it and make it inactive.
Picklist valueIt is built in, or it is used on at least one record.Edit it and set Visibility to hidden.
Unit of measureIt 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.
Deactivate first, delete never

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

Section 55 · Administration · 6 min
Goal: Set how inbound calls ring, turn texting on for a workspace number, and choose when leads count as going cold.
Admin & manager note

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.

CRM settings on Calling with availability check, ring time, voicemail and menu prompt settings
Calling. How long calls ring, the voicemail greeting and the phone menu callers hear.

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.

Pick the number your follow-up rhythm can keep

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.

Table: Setting, What it does, Limits
SettingWhat it doesLimits
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 voicemailHow long a call rings before it goes to voicemail.Default 25, from 10 to 60.
Let unanswered callers leave a voicemailOn or off.
Greeting read to unanswered callersRead 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 promptWhat 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.

This switch is behind every disabled Send SMS button

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

Section 56 · Administration · 8 min
Goal: Set up the units, budget-line templates and submission checklists your bids start from.
Admin & manager note

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.

CRM settings on Pricing templates with the template list and the template editor with name, when to use it, default type and lines
Pricing templates. Reusable sets of budget lines; applying one only adds the lines an opportunity is missing.

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.

Renaming a unit updates every line

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.

Table: Field, What it does
FieldWhat it does
Template nameWhat people pick from.
When to use itA short description.
Default for opportunity typeOffered 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.
ActiveOnly 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

  1. A general contractor bids on municipal renovation tenders every month. The estimator opens Pricing templates and selects New template.
  2. She names it Interior renovation, sets Default for opportunity type to Tender, and adds sections for Demolition, Framing, Electrical and Finishes.
  3. Under Electrical she adds lines marked Subcontract with Vendor price ticked, so each one prompts for an electrician's quote.
  4. 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).
  5. 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

Section 57 · Administration · 8 min
Goal: Control how quotes look, what vendors receive when you ask for prices, and who you can ask.
Admin & manager note

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.

CRM settings on Vendors and contractors listing CRM contractors and procurement vendors with source, contact, prequalification and status
Vendors and contractors. CRM contractors are edited here; procurement vendors open in Vendors.

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.

Table: Part of the editor, What you set
Part of the editorWhat you set
Company details on the letterheadCompany 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 ColourThe layout and accent color. The government price form always prints in black and white.
ShowLogo, the GST line and total with tax, optional items, page numbers.
Text sizeNormal or Large.
WordingCover 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.

Tansi does not write your terms

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}.

Table: Field group, Fields Tansi fills in
Field groupFields Tansi fills in
The vendorCompany name, contact full name, contact first name, email.
The requestRequest name, date prices are due, the vendor's private link, number of items, budget lines being priced, number of documents shared.
The bidOpportunity name, client name, client's reference number, when your bid closes.
YouYour name, job title, email, phone, company, and today's date.
Vendor templates only keep changes when you select Save

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

Section 58 · Scenarios · 10 min
Goal: Follow three realistic jobs through the CRM from the first contact to delivery.

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

  1. 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.
  2. The estimator opens the lead, sees No next action, and selects Add a task to call back tomorrow.
  3. 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.
  4. 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.
  5. Her default pricing template fills the budget; she sends price requests to two electrical subcontractors from the Pricing tab.
  6. 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.
  7. 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

  1. 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.
  2. 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.
  3. The couple books a tour; she converts the lead with an opportunity for the package value.
  4. From the opportunity's Pricing she sends a quote. The couple opens the link, types their names and ticks I accept this estimate.
  5. 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

Not limited to health care

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.

  1. 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.
  2. She adds the clinic's intake coordinator as a Contact, picks the account in the Account field and ticks Primary contact.
  3. 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.
  4. She opens an opportunity for the partnership agreement, then marks it Won when the agreement is signed, recording the contract number and value.
  5. 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

Section 59 · Scenarios · 8 min
Goal: Run the routine checks that keep lists accurate and forecasts honest.

A distributor tidies its accounts

  1. 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.
  2. She selects Show incomplete accounts. The Incomplete view lists only those 38.
  3. She works down the list using the Add industry, Add phone and Assign buttons in the empty cells, without opening each account.
  4. For accounts with no owner, she ticks several rows and uses Assign owner on the bulk bar.
  5. 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

  1. On CRM Home she sets Compare with to Last 7 days and checks the four tiles.
  2. Under Needs attention she selects Assign beside unassigned leads and gives each one an owner from the bulk bar.
  3. She selects Review beside the going-cold row and messages the owners of leads that have gone quiet.
  4. 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.
  5. 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

  1. 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.
  2. She opens the New this week view, filters by the trade show Source, and assigns owners in bulk.
  3. 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.
  4. A third was a contact deleted last year. She finds the person under Archived on the Contacts list and selects Restore, keeping their history.
Small habits beat big clean-ups

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

Section 60 · Worked examples · 4 min
Goal: Follow two complete jobs — a public construction tender and an events supply bid — through the pricing, submission and paperwork screens.

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.

  1. Open the opportunity and go to Pricing › Budget lines. Accept the banner Start from the “Roofing” template? to load your standard breakdown.
  2. Fill quantities and unit costs on the lowest lines — tear-off, membrane, insulation, flashing, crane — and mark the crane line Subcontract with its contractor.
  3. 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.
  4. When prices arrive, open Compare and choose, select Choose per item, watch for Ends before the bid is due, and select Use these prices.
  5. 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.
  6. 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.
  7. 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.
  8. When Ready to submit? reads Everything is ticked., upload to the portal, then Record the submission with the portal's confirmation number and receipt.
  9. 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.
  10. 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.

  1. 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.
  2. On Price sheet, include everything but mark the livestream line Optional so the client sees it priced separately below the total.
  3. 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.
  4. Select Send as quote, tick the event planner and the venue manager under To, and send.
  5. Turn the client portal on from Client access, invite the planner as a Signer, and share the floor-plan document and the quote.
  6. 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.
  7. Use Signers to see 1 of 2 signed, and Copy link if your director cannot find the email.
Let the chips steer you

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

Section 61 · Worked examples · 3 min
Goal: Apply the record tools to ongoing client work: billable time on an account, a supply contract with milestones, and coordinated follow-ups.

An office consultancy: billing a monthly retainer

A small consultancy bills a client for advisory hours each month.

  1. 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.
  2. Consultants log their hours with Track time or Log time; billable Tansi Meet calls add Meeting entries on their own.
  3. At month end, open Billing, pick the Billing month, check Missing rates is zero, and export Account Billing for your bookkeeper.
  4. 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.

  1. The opportunity is won; on Contract & billing, the Contract value line reads From the award recorded when the opportunity was won.
  2. Add four quarterly milestones as fixed amounts and tie the first to the submitted price sheet revision.
  3. When a quarter's deliveries are complete, edit that milestone to Ready to invoice, then select Create invoice and send it from Invoices.
  4. 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.

  1. 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.
  2. Open the Schedule sub-tab to see the tasks as bars against Bid due.
  3. Use Notify to ping the operations manager about the client's dock-hours question; it is logged on the timeline as a Notification.
  4. Book the site walk with Meeting › Schedule meeting, pick the client's time zone, and attach the site map.
  5. 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.
Check what is shared before inviting a client

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

Section 62 · Reference · 4 min
Goal: Work in your own language, and send your clients pages in theirs.
A public CRM page showing the language switcher in its header, with English, French and Spanish available, and the page content rendered in French.
The whole CRM is trilingual. Public pages carry their own switcher, and a link from an email can set the language before the page opens.

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.

Write custom text in every language you need

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

Section 63 · Reference · 5 min
Goal: Look up any CRM route and what it is for.

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

Table: Route, Page and what it is for
RoutePage and what it is for
/crmCRM Home — the overview: key figures, charts, what needs attention and your open tasks.
/crm/accountsAccounts list — the companies you do business with.
/crm/accounts/{id}Account record — one company, with its contacts, opportunities, projects, team, billing and history.
/crm/contactsContacts list — the people at those companies.
/crm/contacts/{id}Contact record — one person, with their timeline, messages and communication preferences.
/crm/leadsLeads list — new interest, with saved views. Deep-linkable with ?view=.
/crm/leads/{id}Lead record — the progress path, next action and conversion.
/crm/leads/formsLead 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/formLead Form editor — the legacy single-form route, kept working.
/crm/opportunitiesOpportunities list — deals, sorted by submission deadline.
/crm/opportunities/{id}Opportunity record — the bid workspace. Tabs are deep-linked with a # hash.
/crm/pipelinePipeline board — open deals as stage columns you can drag between.
/crm/activitiesMy 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/eventsEvents 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-inEvent check-in — the phone-first door page.
/crm/events/spacesSpaces & calendar — the rooms you book across events, and the booking calendar.
/crm/procurement-portalsProcurement Portals — the tender sites you bid on.
/crm/reportsSales reports — pipeline, forecast, activity, win and loss reasons, and performance by owner.
/crm/settingsCRM Settings — opens on Pipeline stages.
/crm/settings/{section}CRM Settings section — one panel, with its own URL and legacy aliases.
/crm/adminCRM Settings — the legacy route, with ?tab= aliases.
/crm/admin/accountsChart of Accounts — the codes quote, invoice and cost lines are coded against.
/crm/campaignsCampaigns — covered in Module 04, Mass Communication.

Public pages, opened from a link

Table: Route, Who opens it and what they see
RouteWho 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-portalVendor 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}/registerEvent registration — buyer details, one block per attendee, questions, order summary and consent boxes.
/events/{slug}/confirmedRegistration 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.
Every one of these links is a door

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

Table: Address, Panel (older names that still work)
AddressPanel (older names that still work)
/crm/settings/chart-of-accountsChart of accounts (financial, accounts)
/crm/settings/unitsUnits of measure (uom)
/crm/settings/pricing-templatesPricing templates (templates)
/crm/settings/submission-templatesSubmission templates (submission, checklists)
/crm/settings/document-formatsQuote and price sheet formats (formats, quote-formats)
/crm/settings/vendor-request-templatesVendor request templates (vendor-templates, vreq)
/crm/settings/vendorsVendors and contractors (contractors, vendors-and-contractors)
/crm/settings/custom-fieldsCustom fields (fields)
/crm/settings/pipeline-stagesPipeline stages (stages) — the default panel
/crm/settings/picklistsPicklists; add ?field=LossReason to open one list
/crm/settings/tagsTags
/crm/settings/leadsLeads
/crm/settings/callingCalling
Module 04 · Sales & Clients

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

Section 0 · Getting oriented · 4 min
What you’ll get: Decide whether this module is yours to use, and gather the three things a campaign cannot be sent without.

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

  1. 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.
  2. 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.
  3. 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.

Admin & manager note

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.

Opening someone else's draft sends from their workspace

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.

The Campaigns list at /crm/campaigns. A toolbar across the top holds a search box reading Search name or subject, Channel and Status selects, a Created date range and a Show archived switch. Below it a table of campaigns with columns Name, Status, Audience, Opens, Clicks, Sent, Sent by and a kebab menu. Each name carries a small origin chip reading CRM or Mass Communication.
One list, every campaign. The origin chip under each name tells you which door the campaign was created behind. Both doors show the same pool.

Glossary

Section 1 · Getting oriented · 6 min
Goal: Recognize the words this module uses before you meet them in a dialog.

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.

Table: Term, What it means
TermWhat it means
CampaignOne email or one text message, its audience, its schedule and its results, stored as a single record.
ChannelEmail or SMS. A campaign is one or the other, chosen on step 1, and cannot be both.
OriginWhether 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.
AudienceThe rule that decides who receives the campaign — for example all leads with the status New — rather than the people themselves.
Record typeWhich kind of CRM audience you are building: Leads, Contacts, Event attendees, or Specific companies, people or tags.
SelectionThe Specific companies, people or tags record type. It is the only audience that can be combined with subscriber lists, Tansi users and pasted addresses.
RecipientOne person on one campaign, stored as a row of its own once the campaign is queued. This is what the report counts.
SnapshotThe 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 listA mailing list people sign themselves up to. Lists belong to Mass Communication but can be combined into a CRM Selection audience.
Subscriber-only contactA 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 listA 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 textA flag on one lead or contact that stops campaigns on that channel reaching that person.
Consent sourceHow 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 noticeAn operational email to your own Tansi users only. It carries no unsubscribe link and reaches staff who have unsubscribed from newsletters.
Merge tokenA placeholder in your text that is filled in per person. There are exactly three: {FirstName}, {LastName}, {CompanyName}.
BlockOne piece of the email — a heading, a picture, a button. An email is a stack of blocks.
CanvasThe editor where you build and arrange blocks, with the email drawn as it will be sent.
Starter layoutOne of three skeleton designs that ship with Tansi: Newsletter, Announcement, Promotion.
TemplateA design you saved for re-use. Templates belong to the workspace, not to a section.
AssetAn image or a file uploaded to the campaign library and used inside a block.
Tracking tokenA 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 rateOpens divided by delivered recipients.
Click rateClicks divided by delivered recipients.
Hard bounceA permanent delivery failure. The address is added to the suppression list.
Soft bounceA temporary failure such as a full mailbox or a busy server. Nobody is suppressed and the mail may still arrive.
ComplaintA recipient marked the email as spam. The address is suppressed.
SweepThe background job that picks up queued campaigns and sends them. It runs once a minute.
QueuedHanded over to the sweep. The audience is already frozen at this point.
ScheduledHow the screen describes a queued campaign whose send time is still in the future. It is not a stored status of its own.
ArchivedHidden from the list. It is a flag, not a status, and it changes nothing about a send that already happened.
CASLCanada's Anti-Spam Legislation. It governs consent, sender identification and unsubscribe for commercial electronic messages.
Double opt-inA per-list setting where a signup is only confirmed after the person clicks a link in a confirmation email.
PollA one-question block inside the email. Each answer is a link, and the results appear on the campaign report.

Which Campaigns am I in?

Section 2 · Getting oriented · 6 min
Goal: Tell CRM Campaigns and Mass Communication Campaigns apart, and explain why the same campaign shows up in both.

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

Table: , CRM Campaigns, Mass Communication Campaigns
CRM CampaignsMass Communication Campaigns
Where it livesSales & Clients › CampaignsMass Communication › Send › Campaigns
Address/crm/campaigns/comms/campaigns
What lets you inThe CRM administration featureMass communication access
Audience sources it addsLeads, contacts, companies, tags, event registrantsSubscriber lists, pasted addresses, Tansi users
ChannelsEmail and SMSEmail in practice — texting is a CRM audience feature
Origin chip on the rowCRMMass 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.

Which door should I use?

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

Section 3 · Your campaigns · 8 min
Goal: Find any campaign by name, status or date, read its row at a glance, and use the row menu without losing anything.

/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.

The campaign list with the row menu open on a draft showing Open, Edit / send and Delete draft
A draft's menu. Drafts offer only Open, Edit / send and Delete draft.

When there is nothing to show yet, the table reads No campaigns yet and invites you to click New campaign to create one.

The Campaigns list at /crm/campaigns. A toolbar across the top holds a search box reading Search name or subject, Channel and Status selects, a Created date range and a Show archived switch. Below it a table of campaigns with columns Name, Status, Audience, Opens, Clicks, Sent, Sent by and a kebab menu. Each name carries a small origin chip reading CRM or Mass Communication.
One list, every campaign. The origin chip under each name tells you which door the campaign was created behind. Both doors show the same pool.

Narrowing the list

Table: Control, What it does
ControlWhat it does
Search boxPlaceholder 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.
ChannelEmail or SMS. Clearable.
StatusAny one of the six stored statuses. Clearable. Note that there is no Scheduled option — a scheduled campaign is stored as Queued.
CreatedA date range on the creation date. The end day is included in full.
Show archivedOff by default. Turn it on to bring archived campaigns back into view.
Export menuTop 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

Table: Column, What it tells you
ColumnWhat it tells you
NameA 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.
StatusA colored chip. A queued campaign with a future send time reads Scheduled here, even though Queued is what is stored.
AudienceA 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.
OpensThe open rate with a small bar. A dash when nothing has been delivered.
ClicksThe click rate, the same way.
SentThe scheduled date and time for a scheduled campaign, otherwise the date it was queued, otherwise a dash.
Sent byWhoever created the campaign.
ActionsThe ⋮ 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.

Table: Item, When it appears
ItemWhen it appears
OpenAlways.
Edit / sendDrafts only. Re-opens the editor on the saved draft.
Delete draftDrafts only.
Cancel scheduled sendOnly while the campaign is queued with a send time still in the future.
DuplicateAny 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.
ArchiveOnly on a campaign that is not a draft and is not queued or sending. A draft can only be deleted.
RestoreOnly on an archived row.
Drafts have a shorter menu

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

Table: Action, What the dialog says, and what happens
ActionWhat the dialog says, and what happens
ArchiveArchive campaign — the campaign will be hidden from the list and can be restored with Show archived. You then see Campaign archived.
Delete draftDelete draft — the draft will be permanently deleted and this can't be undone. You then see Draft deleted.
Cancel scheduleCancel 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 failedRetry 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.
Delete draft is permanent; everything else is only hidden

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.

A campaign that is queued or sending cannot be archived

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

Section 4 · Making a campaign · 9 min
Goal: Move through the editor confidently, fill in every field on the compose and review steps, and rely on autosave instead of fearing it.

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.

The campaign editor dialog, titled Edit draft. A three-part step bar across the top reads 1 Audience, 2 Compose and 3 Review and send, each with a one-line summary of its own state. The form fills the left side and a Live preview pane sits on the right. The footer shows Cancel, Save draft and Next.
Three steps, one dialog. The step bar is clickable, so you can move between steps in any order. The preview on the right redraws as you type.

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

Table: Field, What to put in it
FieldWhat to put in it
Campaign nameRequired, 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.
SubjectRequired 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 bodyOnly for text campaigns and for older plain-text campaigns: a single eight-line text area.
Start withOn 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.

Table: Field, What to put in it
FieldWhat to put in it
Summary tableRead-only: campaign name, channel, audience and subject, as they stand.
From nameUp 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 emailUp to 256 characters, validated. Where replies land. Use a mailbox somebody actually reads.
Test email addressEmail with a block design only. Pre-filled with your own address. See Test sends and previewing.
Send now / Schedule for laterA 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 closes the editor

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.

Let the 60-second save do its job

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

Section 5 · Making a campaign · 9 min
Goal: Build an email out of blocks, edit text in place, and undo anything you regret.

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.

Step 2, Compose. Campaign name, Subject and Preview text fields across the top. Below them a bar with Undo, Redo, a Templates menu, a Desktop and Mobile toggle and a Sample data switch, the email drawn on the canvas, and an Email styles panel on the right with accent, backdrop, email and text colors. Merge-token chips, a Template name box and a Start over button run along the bottom.
What you build is what is sent. The canvas draws the email with the same styles the sender uses, and the footer is added to every email automatically.

The top bar

Table: Control, What it does
ControlWhat it does
UndoCtrl+Z. Steps back through your changes.
RedoCtrl+Y, or Ctrl+Shift+Z.
Templates ▾A Starter layouts group, then Saved templates.
Desktop / MobileChanges the width the canvas is drawn at, so you can see how the design reflows on a phone.
Sample dataFills 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.

Admin & manager note

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

Table: On the canvas, Means
On the canvasMeans
No image yet — choose one in the side panelAn Image block with no picture.
No file yet — choose one in the side panelA File block with no file.
Empty HTML block — add its code in the side panelAn HTML block with no code.
Empty columnA column with nothing in it; use its +.
This block can't be shown hereA block the canvas cannot draw; it is kept.
Type a heading / Type text / Button labelPlaceholder 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

Section 6 · Making a campaign · 7 min
Goal: Choose the right block for each piece of your message and know what each one can be set to.

The Add a block menu offers ten types, always in this order: Heading, Text, Button, Image, Columns, Divider, Spacer, File, Poll, HTML.

The Add a block menu, a grid of ten choices in order: Heading, Text, Button, Image, Columns, Divider, Spacer, File, Poll and HTML, each with its own icon.
Ten kinds of block. Inside a Columns block the menu is shorter — Poll, File and Columns are left out.
Table: Block, What it is for, and what it starts as, Its own settings
BlockWhat it is for, and what it starts asIts own settings
HeadingA section title. Starts as Your heading, level 2, aligned left.Heading level (1 largest, 2, 3 smallest) and Alignment.
TextA paragraph. Starts as Write something….Text size: Small, Normal or Large.
ButtonA call to action. Starts labeled Click here, centered, with no link.Button link (URL), which must begin http or https, and Alignment.
ImageA 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.
ColumnsTwo or three side-by-side areas you can drop other blocks into. Starts as 2 empty columns.Number of columns, 2 or 3.
DividerA horizontal rule between sections.None — the panel says a divider has no options beyond spacing and background.
SpacerEmpty vertical room. Starts at 24 px.Height, a slider from 4 to 120 px.
FileA download link to a file in your asset library. Starts with no label.File (choose or replace) and Label.
PollA 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.
HTMLHand-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 canvas with the heading block selected. A small toolbar above the block offers drag, move up, move down, duplicate and delete, and an Insert field menu sits beside it. The side panel, on its Selected: Heading tab, shows Heading level, Alignment, Spacing above, Spacing below and Background colour. A second tab is labeled Email styles.
Per block, then per email. Every block gets spacing and a background. The Email styles tab sets colors, font and width for the whole message.
Reach for Auto before you reach for the slider

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

Section 7 · Making a campaign · 9 min
Goal: Set the look of the whole email, use columns within their rules, and manage the images and files your campaigns depend on.

Email styles

The second tab of the side panel sets the look of the whole message rather than one block.

Table: Setting, What it controls
SettingWhat it controls
Accent colour (buttons)The button color.
Backdrop colourThe area around the email card.
Email colourThe card the blocks sit on.
Text colourThe body text.
FontModern sans, Classic serif, or Rounded.
Content widthA slider from 480 to 800 px.
Show logoWhether 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.

There is no logo picker on this screen

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.

Table: Rule, Detail
RuleDetail
Image formatsPNG, JPG, GIF and WEBP. SVG is rejected — mail clients handle it badly and it can carry script.
File formatsPDF, DOC, DOCX, XLS, XLSX, TXT and ZIP, plus whatever else your workspace allows as a document.
Size capsImages up to 5 MB, files up to 25 MB.
Large imagesAnything bigger than 1200 × 1800 is scaled down and re-encoded on upload. GIFs are passed through untouched so animation survives.
DeliveryAssets are served to recipients through a long-lived public link, so images load in old email even years later.
Assets cannot be deleted, and removing one would not unsend it

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.

You cannot delete from the library

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

Table: Limit, Value
LimitValue
Blocks per email100, counting blocks nested inside columns. Over that: An email holds at most 100 blocks.
Whole design size200 KB. Over that: The campaign design is too large.
One HTML block20 KB.
Content widthClamped to 320–800 px when saved.
Spacer height4–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

Section 8 · Who gets it · 11 min
Goal: Build an audience out of CRM records, check it before you commit, and understand exactly when the list is frozen.

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.

Step 1 of the campaign editor. Subscriber lists, a box for pasted email addresses and a Tansi users search sit above a CRM records section with a Record type select set to Leads, a Channel select set to Email, and Status, Source and Owner fields. Below them a Preview audience button, an information line reading 1 will receive with duplicates and skipped recipients counted, and a Review recipients button.
Who it reaches. Preview audience gives you a point-in-time count. The real count is taken again the moment you press Send.

CRM records

Table: Field, What it does
FieldWhat it does
Record typeLeads, Contacts, Event attendees (only if your workspace has events and you can reach them), or Specific companies, people or tags.
ChannelEmail or SMS. SMS is disabled, with an explanation, when the workspace has no phone number.
Status / SourceOn 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 / PeopleOn 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.
The ID fields take raw numbers, not names

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

Table: Record type, Who it actually reaches
Record typeWho it actually reaches
LeadsLive 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.
ContactsLive 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 attendeesRegistrations 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.
SelectionEverything 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.

Pasted addresses become real contact records when you send

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

The audience is resolved when you send, not when you save

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

Section 9 · Who gets it · 9 min
Goal: State precisely which opt-out stops which message, and never send to somebody who has said no.

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.

Leaving a list is not unsubscribing

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

Table: Opt-out, Stops, Does not stop
Opt-outStopsDoes not stop
Do not email on the recordEvery email campaign that reaches that lead or contact.Text campaigns. Mail to a different address held by somebody else.
Do not text on the recordEvery text campaign to that person.Email campaigns.
Suppression: unsubscribedEvery email campaign to that address, in that workspace.Text campaigns. Staff notices to Tansi users (see below).
Suppression: hard bounceEvery email to that address, including staff notices.—
Suppression: spam complaintEvery email to that address, including staff notices.—
Left a subscriber listCampaigns 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.

Use staff notices only for what they are for

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

Section 10 · Getting it out the door · 6 min
Goal: Check a campaign properly before it goes, and know what the two checking tools do and do not prove.

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 Live preview pane. A Desktop and Phone toggle sits at the top, then the subject line, a switch reading Fill merge tokens with sample data, and the rendered email below in a framed, scrolling panel.
A rendering, not the email. Nothing in the preview is clickable. Use a test send when you need to check how it behaves in a real inbox.

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.

Table: The preview says, Because
The preview saysBecause
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.

Step 3, Review and send. A summary table lists the campaign name, channel, audience and subject, above the recipient count, From name and Reply-to email fields, a Send a test area with a Test email address box and a Send test email button, and the Send now and Schedule for later choices.
Five tests per ten minutes. Test sends carry a [Test] subject prefix and sample merge values, and nothing about them reaches any report.
Table: What a test send does, Detail
What a test send doesDetail
SubjectPrefixed with [Test] , so you can never confuse one with the real thing.
Merge tokensAlways filled with the sample values Alex, Morgan and Acme Inc. — never with a real person's details.
TrackingNone at all. No tracking token, no open pixel, and links go to their real destinations rather than through the redirect.
RecordsNothing is written. No campaign row, no recipient, no activity on anybody's timeline, nothing in any report.
ValidationLooser than a real send, so an unfinished design can still be test-sent.
Rate limitFive test sends per person per ten minutes. Over that: Too many test emails — try again in a few minutes.
Mailing addressStill required. A test send is refused without one, the same as a real send.
What to check in a test, in order

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.

A test does not prove the real email will track

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

Section 11 · Getting it out the door · 9 min
Goal: Send or schedule a campaign deliberately, predict when it will actually arrive, and recognize the point of no return.

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 scheduling area of step 3. Two radio choices read Send now and Schedule for later. Schedule for later is selected and shows a Send date and a Send time field, with help text saying times are your local time and a scheduled campaign can be cancelled back to a draft until the send starts.
Now is final, later is not. A future schedule can be canceled back to a draft. Send now cannot be undone once you confirm.

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}.

Queueing cannot be undone

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.

Canceling a schedule deletes the recipient snapshot

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

Table: If this is true, You get
If this is trueYou 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 contextPick a tenant before creating a campaign.
The audience resolves to nobodyNo recipients match this audience.
The design has no blocksThe design needs at least one block.
The scheduled time is in the pastThe scheduled send time must be in the future.
Admin & manager note

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

Section 12 · After it goes · 10 min
Goal: Interpret every number on a campaign report honestly, including the ones that flatter you and the ones that do not.

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 campaign report. Five cards across the top read Delivered, Open rate, Click rate, Unsubscribed and Bounced, each with a percentage and a supporting line. Below them a Top links table and a line chart titled Opens in the first 48 hours.
What came back. Every engagement rate is measured against delivered recipients, so no rate can exceed 100%.

The five cards

Email campaigns show all five. A text campaign shows only Delivered, because there is nothing else to measure.

Table: Card, How it is calculated, What to watch for
CardHow it is calculatedWhat to watch for
DeliveredSent 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 rateOpens over delivered.Always an undercount. Many mail clients block the tracking image.
Click rateClicks over delivered.More reliable than opens, because a click is a real action.
UnsubscribedUnsubscribes over delivered.A sharp rise is the signal to look hard at your audience, not at your subject line.
BouncedHard 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.

Open rate is a floor, not a measurement

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.

The recipients table on a campaign report. Tabs read All recipients, Opened, Clicked, Didn't open, Bounced and Unsubscribed. The table below has columns Name, Email, Type, Status, Sent at, Opened, Clicked, Unsubscribed and Error.
Person by person. The export menu exports the tab you are looking at, not the whole list.

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

Table: Signal, How Tansi learns about it
SignalHow Tansi learns about it
OpenA 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.
ClickEvery 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 voteRecorded, then the person is sent to the thank-you page. Voting again replaces the earlier answer rather than adding one.
BounceReported back by the mail provider. A permanent failure is a hard bounce and suppresses the address; anything else is soft and suppresses nobody.
Spam complaintReported 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.

The campaign history panel on a contact's detail page. A table with columns Campaign, Channel, Outcome and Sent lists the campaigns that reached this person.
One person's view. The panel on a contact or lead reads the recipient records, so skipped and failed sends show here even though they never reach the timeline.

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.

Table: Button, When it appears, What happens
ButtonWhen it appearsWhat happens
Edit / sendDrafts, with a workspace in contextOpens the editor on the draft.
Delete draftDraftsAsks, deletes, and returns you to the list.
Cancel scheduled sendQueued with a future send timeReturns it to a draft.
DuplicateAny non-draft, with a workspace in contextOpens a copy. If you send or save it, you return to the list.
Resend…Finished campaignsOpens the Resend dialog.
RefreshWhile sendingReloads the numbers (they also refresh every five seconds).
Retry failed (n)When something failedQueues a retry and opens it.
Archive / RestoreNon-drafts not queued or sending / archived onesArchive 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 from a Mass Communication report is labeled CRM

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

Section 13 · After it goes · 7 min
Goal: Pick the right one of the three ways to send something again, and avoid mailing people twice.

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 Resend dialog. An introduction explains that resending queues a new campaign with this campaign's content, followed by three radio choices: Original recipient list, Non-openers only, and Pick a new list which opens a copy in the campaign wizard.
Resending makes a new campaign. It re-targets the stored recipient snapshot. It never re-runs your audience filter.

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

Table: You want to, Use
You want toUse
Send the same message again to the same peopleResend… → Original recipient list
Chase the people who did not open itResend… → Non-openers only
Send the same message to a different audienceDuplicate, then edit step 1
Re-attempt the addresses that failedRetry failed (n)
Change the wording before sending againDuplicate
Retry and Resend send immediately

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

Section 14 · Law and language · 10 min
Goal: Explain what every recipient is offered, what each choice does to their record, and why the footer cannot be edited.

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.

What this section is and is not

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 footer at the bottom of a campaign email. Three lines read: This email was sent by the workspace via Tansi; the workspace's postal address; and You received this because you're a contact of the workspace, followed by an Unsubscribe link.
Added to every email, automatically. You cannot edit it, and without a mailing address on the workspace nothing can be sent.

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.

The public unsubscribe page with an English, Español and Français switcher, showing the message This link isn't valid and the explanation that the unsubscribe link is out of date or incomplete.
One of three states. A working link lists the visitor's lists with Unsubscribe from these lists and Unsubscribe from all emails; an old or broken link shows this message instead.
Opening the page changes nothing

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:

Table: Choice, What it does to the person's record
ChoiceWhat it does to the person's record
Unsubscribe from these listsShown 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.

Your part of the bargain

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

Section 15 · Law and language · 4 min
Goal: Set expectations correctly about what Tansi translates in a campaign and what it does not.

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.

Set the language on the record, not on the campaign

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

Section 16 · Worked examples · 9 min
Goal: Follow two real campaigns from an empty editor to a confirmed send, and copy the habits that keep them safe.

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.

  1. Open Sales & Clients › Campaigns and select New campaign.
  2. On step 1, set Record type to Specific companies, people or tags. Under Tags, pick General contractor. Leave Channel on Email.
  3. 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.
  4. 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.
  5. Select Next. Type the Campaign name (Open house invite — May), the Subject and a short Preview text (optional).
  6. Under Start with, pick the Announcement starter. The canvas opens.
  7. 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://.
  8. Select the + after the text and add a Poll. Set the Question (Which session suits your crew?) and three Answer options.
  9. Turn on Sample data and switch to Mobile to see how the greeting and the button look on a phone.
  10. 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.
  11. 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.
  12. Choose Schedule for later and set a time fifteen minutes from now. That gives you an undo window.
  13. Select Schedule campaign, read the confirmation (subject, head count, how many were left out) and press Schedule.
Why fifteen minutes

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.

  1. 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.
  2. Select New campaign. Set Record type to Event attendees. If that choice is missing, you do not have access to Events in this workspace.
  3. Pick the Event. Leave Registration status on Confirmed. Narrow with Passes (optional) if only exhibitor-pass holders should get it.
  4. 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.
  5. 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.
  6. Select Next. Text campaigns have no From name, Reply-to or test send.
  7. 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.

Do not edit workspace settings during a send

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

Section 17 · Worked examples · 8 min
Goal: Chase non-openers, retry failures and re-run a past campaign for a new audience without mailing anyone twice by accident.

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.

  1. Open the campaign's report from the list.
  2. Select Resend… in the header (or in the row menu on the list).
  3. 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.
  4. Select Resend once. The button reads Queuing…, then Tansi opens the new campaign's report, named with (resend).
A resend goes out immediately

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.

  1. 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.
  2. Select Retry failed (42). The dialog Retry failed sends says it queues a new campaign and cannot be undone.
  3. 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.

  1. 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.
  2. 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.
  3. On step 2, update the dates in the text. The poll, if any, starts again at zero votes.
  4. Test, then schedule as in Example 1.
Table: You want to, Use
You want toUse
The same message again, to exactly the people it reachedResend… › Original recipient list
A reminder to people who did not openResend… › Non-openers only
Another try for addresses that failedRetry failed (n)
Changed wording, a new audience, or a review before it goesDuplicate

Messages you may see, and what to do

Section 18 · Messages and errors · 7 min
Goal: Recognize every warning and error the campaign screens show and know the fix for each one.

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

Table: Message, What it means, What to do
MessageWhat it meansWhat 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

Table: Message, What it means, What to do
MessageWhat it meansWhat 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

Section 19 · Reference · 6 min
Goal: Name the status a campaign is in, say what moves it onward, and know which moves cannot be reversed.

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.

Table: Status, What it means, How it is labeled on screen
StatusWhat it meansHow it is labeled on screen
DraftStill being built. Nothing has been sent and no recipients are fixed.Draft
QueuedHanded to the sending job. The recipient list is already frozen.Queued, or Scheduled when the send time is in the future
SendingThe job has claimed it and is working through the batches.Sending
CompletedFinished with no failures.Sent in the list, Completed on the report
PartiallyCompletedFinished with some sent and some failed.Partially sent / Partially completed
FailedFinished with nothing sent.Failed

Every move a campaign can make

Table: From, To, What causes it
FromToWhat causes it
—DraftSaving a draft, by hand or by the 60-second autosave.
DraftQueuedSend or Schedule from the editor. Tansi validates, freezes the audience and records the queue time plus any scheduled time.
—QueuedSending with no draft behind it, a Retry failed, or a Resend. Each of these creates a brand-new campaign that is already queued.
QueuedDraftCancel 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.
QueuedSendingThe once-a-minute job claims it — one campaign per minute, oldest first, never an archived one, and never before its scheduled time.
SendingCompletedThe run finished with no failures.
SendingPartiallyCompletedThe run finished with both successes and failures.
SendingFailedNothing 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.
SendingFailed or PartiallyCompletedAn 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 FailedarchivedArchive. A flag, not a status.
archivednot archivedRestore.
DraftgoneDelete 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.

Reading a stuck campaign

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

Section 20 · Reference · 3 min
Goal: Find the right address for any part of campaigns, including the pages your recipients see.

Pages you use

Table: Address, Name, What it is for
AddressNameWhat it is for
/crm/campaignsCampaignsThe campaign list, the filters and the New campaign button.
/crm/campaigns/{id}Campaign reportOne campaign's results: the five cards, top links, the opens chart, poll results, the recipients table, the message and the details.
/comms/campaignsMass Communication CampaignsThe other door onto the same pool of campaigns, offering subscriber lists, pasted addresses and Tansi users as audiences.
/comms/campaigns/{id}Campaign reportThe same report, reached from the Mass Communication side.
/crm/contacts/{id}Contact detailCarries the campaign history panel for that contact.
/crm/leads/{id}Lead detailCarries 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.

Table: Address, Name, What it is for
AddressNameWhat it is for
/unsubscribe/{token}UnsubscribeThe 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-youConfirms the answer a recipient chose, and shows the running results when Show results to voters was turned on.
Module 05 · Courses & certifications

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

Section 0 · Getting oriented · 3 min
What you’ll get: Know which half of this module is yours.

Two halves, and you probably only need one

Training is the clearest-cut module in Tansi. Its two section buttons say it all:

Table: Section, You are…, What you do here
SectionYou are…What you do here
Learna learnerFind courses, take them, collect your certificates.
Delivera trainer or administratorBuild 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.

You will not see every page shown here

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.

About the screenshots

Every screen here is a real capture from a demo workspace.

Glossary

Section 1 · Getting oriented · 3 min
Goal: Meet the words before they turn up in the instructions.
Table: Term, What it means
TermWhat it means
CourseA piece of training made of steps you work through at your own pace.
WebinarTraining delivered live at a set time, that you register for.
EnrollmentBeing signed up to a course. Assigned to you, or chosen by you. The course list button is labeled SHOW ENROLMENT on screen.
Pass markThe score you need to pass. Set per course — 70% and 80% are common.
CertificateProof you completed a course. Issued from a certificate template.
Certificate templateThe design a certificate is issued from. One is the default.
Draft / Published / ArchivedA course's status. Only published courses can be taken; archived ones are retired but kept.
Manual gradingMarking short-answer quiz responses a computer can't score.
AssignmentWork a learner submits for a person to review.
ResourceA document, video or other reference material in the library, alongside the courses rather than inside them.
Category / TagHow resources are filed and labeled so they can be found.
xAPIA standard for recording learning activity, including activity that happens outside Tansi.
LRSLearning Record Store — where xAPI statements are kept.
LicenseSeats on a course bought by a company for its people.
Bill-Me-LaterA company asking to be invoiced rather than pay up front.
Public storeA shareable page listing the courses you have published publicly.

Finding and taking training

Section 2 · For learners · 5 min
Goal: Find a course, take it, and know where your progress is tracked.

Browse Courses

Discover training courses and webinars to advance your career. Everything available to you, in one catalog.

Tansi Browse Courses and Webinars showing course cards with prices, ratings and durations, beside filters for category, price, rating, duration and certificate
Browse Courses & Webinars. The catalog. Filters down the left, cards on the right, each showing price, rating and length. The All / Courses / Webinars buttons switch between the two kinds of training.
Table: Control, What it does
ControlWhat it does
All / Courses / WebinarsSwitch between self-paced courses and live webinars, or see both.
CategoriesNarrow to a subject area.
PriceFree only, or a minimum and maximum.
Rating4+, 3+, 2+ stars, or any.
DurationUnder 1 hour, 1–3 hours, 3–10 hours, 10+ hours.
CertificateOnly training that issues a certificate.
Sort byReorder the results — newest first by default.
CLEAR ALL FILTERSStart 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.

Certificates land in your profile too

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

Section 3 · For trainers · 7 min
Goal: Create a course, get it published, and know what the statuses mean.

Course Management is where training is built: create, manage, and publish training courses for your organization.

Tansi Course Management showing counters for all, draft, published and archived courses above a table of courses with status, category, pass mark and length
Course Management. The trainer's side. Counters for All / Draft / Published / Archived, then every course with its status, category, pass mark and length. Three view modes: Table, Cards and Kanban.

The four counters

Table: Counter, What it means
CounterWhat it means
All coursesEverything, whatever its state.
DraftBeing built. Nobody can take a draft.
PublishedLive. These are what learners see in the catalog.
ArchivedRetired. 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

Table: Control, What it does
ControlWhat it does
CREATE COURSEStart a new one.
TABLE / CARDS / KANBANThree ways of looking at the same list. Kanban is useful while several courses are in progress.
SHOW ENROLMENTBring enrollment numbers into the view. (Tansi spells this button ENROLMENT; it is quoted here exactly as it appears on screen.)
Set up your public storeConfigure the shareable page listing your public courses.
BACKFILL CERTIFICATESIssue certificates for completions that predate the certificate setup.
Fill in description, duration and category

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.

Admin & manager note

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

Section 4 · For trainers · 4 min
Goal: Find the work waiting on you, and know which page it lands on.

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.

Table: Page, What waits there, Counter
PageWhat waits thereCounter
GradingShort-answer quiz responses that a computer cannot score. Tansi calls it Manual Grading.Awaiting review
Pending SubmissionsAssignment 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.

Check both

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

Section 5 · For trainers · 4 min
Goal: Control what a certificate looks like and when it is issued.

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.

Tansi Certificate Templates listing a template with its layout, default flag, status and created date
Certificate Templates. What a certificate looks like when it is issued. Each template has a layout, a status, and one is marked as the default.
Table: Column, What it tells you
ColumnWhat it tells you
NameWhat the template is called.
LayoutLandscape or portrait.
DefaultWhether this is the one used when a course doesn't name another.
StatusActive or not. Only active templates can be used.
CreatedWhen 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.

Certificates are already issued from the template

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.

Backfilling

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

Section 6 · For trainers · 5 min
Goal: Understand the money side — revenue, fees, licenses and invoicing.

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.

Tansi Payment Reports showing course revenue, platform fees, net earnings and refund rate, above transaction and license summary tables
Payment Reports. Revenue, fees and licenses for courses you sell. Net earnings is what reaches you after the platform fee and tax.
Table: Figure, What it means
FigureWhat it means
My course revenueGross, from completed sales.
Platform feesDeducted by the platform.
Net earningsAfter fees and taxes. This is what actually reaches you.
Refund rateRefunds 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.

Licenses are seats, not people

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

Section 7 · For trainers · 3 min
Goal: Publish reference material alongside your courses and keep it findable.

Not everything worth sharing is a course. The Resource Library holds documents, videos and other material that sits alongside the training.

Table: Page, What it does
PageWhat 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.
CategoriesThe subject folders resources are filed under.
TagsLabels for cutting across categories. Each has a name and a slug.
Categories and tags are what make it findable

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

Section 8 · Reference · 4 min
Goal: Understand what these two pages are for, and why you probably won't touch them.

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.

Tansi LRS API Credentials page showing no credentials yet and integration information with an endpoint and authentication method
LRS Settings. API key pairs that let an outside system send xAPI statements into Tansi. Set up once, usually by Tansi — most people never open this.

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.

Credentials are credentials

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.

Admin & manager note

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

Section 9 · Reference · 2 min
Goal: A one-page index of the module.
Table: Menu item, Section, What it's for
Menu itemSectionWhat it's for
Browse CoursesLearnThe catalog of courses and webinars available to you.
My CoursesLearnTraining you're enrolled in, and your progress.
My CertificatesLearnCertificates you've earned, to view and download.
Resource LibraryLearnDocuments, videos and reference material.
Course ManagementDeliverCreate, manage and publish courses.
Certificate TemplatesDeliverThe designs certificates are issued from.
GradingDeliverShort-answer quiz responses needing manual review.
Pending SubmissionsDeliverAssignment submissions awaiting review.
xAPI ActivityDeliverLearning activity recorded through the xAPI standard.
LRS SettingsDeliverAPI credentials for external systems sending xAPI.
Payment Reports ALSODeliverRevenue, fees and licenses for paid courses.
Bill-Me RequestsDeliverCompanies asking to be invoiced rather than pay up front.
Manage ResourcesDeliverAdding and maintaining library resources.
CategoriesDeliverSubject folders for resources.
TagsDeliverLabels for resources.
Webinars

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.

Module 06 · Stock, warehouse & supply

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

Section 0 · Getting oriented · 4 min
What you’ll get: Know what Assets & Inventory is for, which parts apply to you, and why your menu may differ from a colleague's.

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

Table: If you…, You mainly need
If you…You mainly need
Take supplies to do your jobWithdraw Supplies (your workspace may call it something else, such as Dispense) and, if you are asked, My Order Feedback.
Receive deliveriesReceive Deliveries or Inbound Deliveries, and Scan & Receive.
Ask for or order stockThe Hub and the request pages, plus Reorder Suggestions.
Run a stock room or warehouseMost of the Stock and Warehouse pages, Lots and Inventory Reports.
Set the module upThe 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.
A missing page is an access setting, not a fault

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 only for medical supplies

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

Section 1 · Getting oriented · 7 min
Goal: Recognize the words this module uses before they appear in the instructions.

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

Table: Term, What it means
TermWhat it means
ItemA product or asset in your catalog. Items live in the Item Master.
SKUYour own code for an item, such as a part number.
UoMUnit of measure: Each, Box, Vial, Meter — the unit an item is counted in.
AssetAn item tracked one by one and kept, rather than used up.
Category and child categoryThe tree items are filed under. A category can carry its own extra fields, called category fields.
Custom dropdownA 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 riskFlags on an item that show as small labels. Controlled items take extra approval; critical items must never run out.
Credit returnThe supplier takes the item back for credit, so you send it back instead of throwing it away.
GTIN, GS1 barcodeThe 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-UPCAn outside product database Tansi can look a barcode up in, to fill in a new item.

Locations

Table: Term, What it means
TermWhat it means
LocationA place in your hierarchy: a region, site, warehouse, room, shelf or bin. Each one answers to the location above it, its parent.
Location typeThe 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 areaA free-text name for a spot inside a location (for example Cabinet 2), used on older stock and in some dialogs.
TierA 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 locationA location a supplier can deliver to. It is offered in a purchase order's Ship To picker.
Receives in TansiA location whose people receive deliveries in Tansi, so stock is sent to it as a transfer.
Partner siteA location you can send to or request from but whose stock you cannot see.
Assigned peoplePeople 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

Table: Term, What it means
TermWhat it means
On handEverything physically there.
ReservedOn hand, but already promised to a request or held.
AvailableOn hand minus reserved: what you can actually use.
Min, Reorder, MaxStock 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 overrideMin, reorder and max set for one location only, instead of the item's default.
Order multipleOrder quantities round up to this number, for example cases of 12.
Lead days, Safety daysHow long a delivery takes, and how many extra days of stock to keep.
Ordering scheduleHow often a facility is due to order, for example every second Monday. A blackout date is a day it does not order.
RequestThe paperwork that moves stock: a Supply Request, Purchase Order, Stock Transfer or Return.
Request templateA saved list of items to start a request from.
Not allowed itemAn item a location may not order. Blocks set on a parent apply to every location under it.
External POYour finance system's purchase order number. Your workspace names it.
Exceptional receiptA delivery received without a Tansi purchase order or transfer behind it.
Delivery withdrawalStock shipped to a department or place with nobody on Tansi to receive it.
Return on holdStock a station sent back, held until someone restocks, disposes of or returns it.
Days of coverHow long stock lasts at its average daily use.
SnapshotA saved copy of the reorder list at a moment in time.
Funding sourceWhere the money came from, tagged onto lots and order lines for reporting.
CarrierA shipping company, such as a courier or freight line.
Order feedback surveyA form sent to sites asking what they need, before a buyer places orders.

Lots and expiry

Table: Term, What it means
TermWhat it means
LotA 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 itemAn item that requires a lot number or an expiry date when it is received.
(Unspecified) lotStock of an item that came in without a lot number. You can give it real lots later with Assign lots to untracked stock.
ActiveA normal lot that can be used and sent.
QuarantinedA lot on hold while something is checked. It is still on hand, but must not be shipped or used.
SuspendedA lot temporarily taken out of use.
RecalledA lot under a recall notice from the maker or supplier.
FlaggedOn the Lots board: recalled, quarantined or expired lots.
Expiry windowHow far ahead counts as expiring soon. You can set it in days, weeks, months or years.
FEFOFirst 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

Table: Term, What it means
TermWhat it means
WithdrawalRecording supplies issued to a person, there and then.
DispenseOpen 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 unitsThe item switch that counts stock in the doses or units inside each container (container mode).
ContainerOne vial, box or package of a multi-dose item, tracked individually, optionally with its own barcode.
Uses modeA multi-use item counted in whole units on the shelf; doses are tracked only on an opened unit.
DoseOne use from a multi-dose unit: one injection, one scoop of cleaner, one can from a case.
In-use windowHow long a unit can be used once opened: the item's Expires after opening (hours).
ClockThe countdown on an open unit, to the end of its in-use window or its lot expiry, whichever comes first.
AdjustmentA correction that says the recorded quantity was wrong.
WasteStock that existed and was lost, with a reason.
Stock ledgerThe complete history of every movement in and out (Transaction History).
Shared accountA station login used by several people; withdrawals and waste then ask for the person's name.

How the module is laid out

Section 2 · Getting oriented · 5 min
Goal: Find any page in Assets & Inventory from the menu without hunting.

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.

Table: Section, Pages, Who uses it
SectionPagesWho uses it
(always shown)Hub, Withdraw Supplies, Move Stock, Receive DeliveriesEveryone, depending on their permissions.
StockItem Master, Stock Levels, Lots, Reserved Stock, Returns on hold, Stock Review, Critical Items, Waste Management, Reorder Suggestions, Order Schedule, Inventory CountWhoever manages what you hold.
WarehouseScan & Receive, Inbound Deliveries, Withdraw for Delivery, Transaction HistoryWhoever handles stock physically.
SurveysManage Feedback, My Order Feedback, Snapshot HistoryBuyers who ask sites what they need, and the sites that answer.
ReportsInventory Reports, Operations Reports, Audit LogSupervisors and anyone who has to account for stock.
AdminCategories, Suppliers, Contracts, Carriers, Custom Dropdowns, Workspace Lists, Location Management, Request Settings, Request Permissions, Access Center, Data Import, Funding SourcesAdministrators. 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.

Start at the Hub

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 only for medical supplies

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.

Admin & manager note

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

Section 3 · Requests · 6 min
Goal: Name the four kinds of request, read a request number, and know which parts of the request pages apply to you.

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

Table: Kind (default name), Number starts, What it does
Kind (default name)Number startsWhat it does
Supply RequestSR-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 OrderPO-Buying from a supplier. Stock comes in from outside.
Stock TransferTR-Moving stock between two of your own sites. Nothing is bought; it changes place.
ReturnRTN-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.

Your workspace may use different names

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

Table: Page, What it is for
PageWhat it is for
HubThe front door: counters, shortcuts to every request page, and your work queues.
New requestSearch for what you need and Tansi suggests the right kind of request.
Request editorWhere a draft is written: where it is going, what is on it, and why.
Request pageOne request, start to finish: its stage, its lines, who approved it, and the buttons for whatever happens next.
ListsMy requests, all requests, and one list per kind.
Approval InboxEverything waiting for your decision.
TemplatesOrders you place again and again, saved once.
Bulk importBuild 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.
Missing buttons are permissions, not faults

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

Section 4 · Requests · 7 min
Goal: Use the hub's counters, cards and panels to start work and spot what is waiting for you.

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 Requests hub with counters for drafts, pending approval, active and completed, and grouped cards for Start and track, request types and Warehouse operations
The Requests hub. This workspace renamed requests to Tansi Requests and purchase orders to Requisition Orders in Request Settings, so every card follows the new names.

The header

Table: Control, What it does
ControlWhat it does
Scan iconScan 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 CSVOpens Bulk import, to build a supply request from a spreadsheet.
New RequestOpens 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

Table: Counter, Counts, Opens
CounterCountsOpens
DraftsRequests started and not sentMy requests
Pending ApprovalRequests waiting on an approverApproval Inbox
ActiveApproved requests being workedAll requests
Completed (30d)Requests finished in the last 30 daysAll requests
The counters are for the whole workspace

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.

Table: Group, Card, Shown when you can…
GroupCardShown when you can…
Start & trackMy Requestsview requests
Approvals (with a count badge)approve requests
All Requestsview every request in the register
Request typesSupply Requests (listed first)view requests
Stock Transfersraise transfers, fill transfers, or view all requests
Purchase Ordersfill purchase orders
Returnsraise returns, fill transfers, or view all requests
Warehouse operationsWarehouse Queuefill transfers
Inbound Deliveriesreceive purchases
Exceptional receiptsreceive 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 Deliverywithdraw for delivery
Move Stockmove stock inside a location
Receive Deliveriesreceive transfers but not purchases
ManageTemplatesmanage request templates
Settingsmanage workflows (opens Requests Admin)
Withdraw Supplies and Dispense are not only for medical stock

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

Table: Panel, What it lists
PanelWhat it lists
Supply Requests to fillOnly 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 requestsYour last five, newest change first, with stage and need-by date. Completed and canceled ones have a Duplicate icon.
My shipmentsTransfers 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 approvalThe top five in your inbox, each with a Review button. Empty: All caught up.
The to-fill panel catches requests no one else sees

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

Section 5 · Requests · 7 min
Goal: Read the stage bar, the fulfillment state and the Progress panel on any request and know what has to happen next.

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.

Table: Stage, What it means, What moves it on
StageWhat it meansWhat moves it on
DraftBeing written. Only drafts can be edited.The requester submits it.
PendingSubmitted 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.
ApprovedAgreed, but nothing has physically moved yet.Work starts: stock is allocated, picked or shipped, or the order goes to the supplier.
ActiveIn progress: being picked, shipped, ordered or delivered.Everything is received or closed.
CompletedFinished.—

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:

Table: Request, Milestones after approval
RequestMilestones after approval
Supply requestSourced (filled with a transfer or a purchase order), Shipped or Ordered, Complete
TransferPicked, Shipped (or Shipped back on a return), Received at …, Complete
Purchase orderOrdered, 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.

Read Progress before you chase anyone

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

Section 6 · Requests · 6 min
Goal: Pick the kind of request that matches where the stock is and where it needs to go.

The question is always the same: where is the stock now, and where does it need to be?

Table: Situation, Raise, Why
SituationRaiseWhy
Your site needs stock and you do not know or care where it comes fromSupply RequestYou 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 moveStock TransferNothing is bought. Stock leaves one site and arrives at the other.
Nobody has it, or it is bought directPurchase OrderStock comes in from a supplier.
Stock at your location is expired, damaged, recalled or extra and should go back to the warehouse that supplies youReturn › Back to the warehouseA return transfer: no purchase order needed. You pick from what your location holds.
A supplier delivered something that must go back to themReturn › Back to a supplierIt 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 buildingNo requestUse 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.
Not limited to medical use

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.

A supply request with nothing in stock anywhere is stopped

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

Section 7 · Raising a request · 7 min
Goal: Use the New request page to search for an item and let Tansi suggest the right kind of request, or start directly.

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:

Table: Tile, Shown when, Button
TileShown whenButton
Request from local stockThe 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 vendorThe 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

Table: Button, What it does
ButtonWhat it does
Purchase Order, Stock Transfer, Supply Request, ReturnOpens a blank editor of that kind. Each shows only if your role may raise it.
Start from existingPick a completed request (filter by Type, search by number or notes). Tansi copies it into a new draft: Created SR-… from SR-….
Start from templatePick 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

Section 8 · Raising a request · 9 min
Goal: Fill in where a supply request or transfer is going, who it is for, and the request details an approver needs.

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.

Screen recording: raising a new supply request, adding lines and submitting it for approval
Watch it done (2 minutes). Raising a supply request from scratch — choosing the destination, adding lines and sending it for approval. The walkthrough recording is in the Module 06 manual.
Screen recording: creating a stock transfer between two locations
Watch it done (1.5 minutes). Moving stock between your own locations, without a supply request behind it. The walkthrough recording is in the Module 06 manual.

Supply details

Where the supplies are going.

Table: Field, What to know
FieldWhat 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 addressWhere the delivery goes, if different.
Request templateAppears only if the location has templates linked to it. See below.
Shared station accounts must say who it is for

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

Table: Field, What to know
FieldWhat 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.

Table: Field, What to know
FieldWhat to know
PriorityLow, 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 byThe date you need it.
ProjectFilled 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.
Lowering the priority needs a reason

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

Section 9 · Raising a request · 8 min
Goal: Fill in the supplier, contract, delivery and return details on a purchase order or a supplier return.

Purchase details

Table: Field, What to know
FieldWhat to know
Supplier (required)Search suppliers. Once chosen, the contact name and email show underneath.
Don't know the supplier? Search by itemOpens 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 locationWhich 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 dateWhen 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 addressThe 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.

The supplier and the items must agree

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.

Table: Field, What to know
FieldWhat 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 toThe vendor (named from the order) or One of our locations (quarantine / warehouse).
Vendor returns addressThe supplier branch whose returns address the carton ships to.
Return authorization (RMA) numberUp to 100 characters. Most suppliers refuse a delivery without one — it can be added any time before shipping.
Destination locationWhen 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

Section 10 · Raising a request · 9 min
Goal: Read and edit every column of the Items table, and clear the lines Tansi flags before you submit.

The Items table appears with the first line. Its columns change with the kind of request.

Table: Column, On, What it holds
ColumnOnWhat it holds
Item / descriptionAllThe item picker, its SKU and handling chips. A description box appears only for an unlisted item or a changed description.
Item locationAll but supplyTransfer: 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.
QtyAllWhole numbers. A short hint under it when something applies (below).
On handAllAvailable 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.
UnitAllUnit of measure, editable.
PriorityAllPer line. A red mark shows when a line is more urgent than the request.
Unit price, Vendor codePurchaseFilled from the supplier's catalog when known.
LotTransfer, return, supplySee below.
ReasonReturnsRequired: why it is going back.
From area, To areaTransfers, when usedShelf or bin inside the From and To locations.
NotesAllUp to 2000 characters per line.
Bin iconAllRemoves 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.

Table: Message, What to do
MessageWhat 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.
Admin & manager note

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

Section 11 · Raising a request · 8 min
Goal: Add items by search, scan, browsing or batch, add things that are not in the catalog, and know why the box may be locked.

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:

Table: Request, Which items you can add
RequestWhich items you can add
SupplyYou can request anything in the supply catalogue, including items that location doesn't stock. Its on-hand shows beside each line.
TransferThe list of items comes from what the From location holds.
Return to the warehouseStock the location holds, up to what is on hand. Each item needs a reason.
Supplier returnOnly items that purchase order delivered.

Ways to add

Table: Control, What it does
ControlWhat it does
Add an item by name or SKUType 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.
ScannerA 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 iconScan with the device camera, where your organization has it turned on.
Browse catalogue / Browse stockA large picker grouped by category. See below.
Add a blank lineAn empty line at the end; the cursor moves into its item picker.
Scan a batchPaste a list of barcodes, or scan many in a row, then add them all at once.
Item not in the catalogueDescribe 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).

The Medications and Medical supplies lists

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.

A zero in the browse window removes the line

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.

The route line can show a placeholder

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

Section 12 · Raising a request · 5 min
Goal: Add freight and fees, check taxes and match the order total to the supplier's quote.

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:

Table: Column, What to enter
ColumnWhat to enter
TypeShipping / freight, Handling, Eco / environmental fee, Recycling fee, Duty / brokerage, Discount or Other.
Description (optional)Up to 200 characters, for example Courier, 2 boxes.
AmountIn dollars. Enter a discount as a negative amount.
TaxesTick if taxable, then pick which taxes apply; otherwise Not taxable.

The summary

Table: Row, What it shows
RowWhat it shows
SubtotalThe lines, with the line count.
Extra costsThe total of the costs on the left.
TaxesOne 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.
AdjustmentAdd adjustment adds a rounding or invoice-difference line, of any sign, never taxed.
Order totalEverything together.
Match the quote before you submit

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.

Costs are hidden from some roles

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

Section 13 · Raising a request · 10 min
Goal: Save a draft safely, and get through every check and question Tansi asks when you submit.

The buttons at the bottom

Table: Button, What it does
ButtonWhat it does
CancelLeaves the editor without saving (back to the request, or to the list for a new one).
Save draftSaves 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 / SubmitSaves, 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.

Cancel does not undo an auto-save

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

  1. Lines needing attention are moved to the top and the submit stops until they are fixed.
  2. Requested on behalf of is required on a shared station account.
  3. Item warnings on transfers and returns: acknowledge restricted or high-risk items.
  4. Your workspace's reminder, if one is set for this kind of request: Before you submit with Submit or Go back and review.
  5. 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.
  6. 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

Table: Dialog, When, Your choices
DialogWhenYour choices
Nothing in stock for this itemA 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 scheduleThe 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 levelAn 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 quantitiesSupply 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 checkPurchase 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.

Converting cancels the original

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

Section 14 · Raising a request · 6 min
Goal: Decide how each short line is sourced in the Stock check dialog, whether you are submitting or approving.

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:

Table: You are, Normal button, With a known shortfall
You areNormal buttonWith a known shortfall
SubmittingConfirm and submitSubmit anyway with known shortfall
Approving (Review sourcing)Apply sourcing planApply anyway with known shortfall
Importing a fileApply choice and create draftCreate 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.

Linked requests are created for you

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

Section 15 · Raising a request · 6 min
Goal: Recall, finish, copy or cancel a request you raised, and understand drafts other people started.

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

Table: Item, Shown to, What it does
ItemShown toWhat it does
Generate packing slipPeople who fill transfersOpens a PDF preview.
Generate purchase orderPeople who fill purchase ordersOpens a PDF preview.
Generate receiving reportPeople who receive or fill requestsOpens a PDF preview.
DuplicatePeople allowed to raise that kindCopies it into a new draft.
Save as templatePeople who manage templatesSaves its lines as a reusable template.
Recall to draftThe requester, while recall is possibleAs above.
Cancel requestPeople allowed to cancel it at its stageAsks 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

Section 16 · Approving · 10 min
Goal: Review a request with its stock, levels and cost, then approve, adjust, source, reject or return it.

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).

Screen recording: an approver opening a pending supply request and approving it
Watch it done (1 minute). The approver's side — opening what is waiting in Approvals and moving the request from Pending to Approved. The walkthrough recording is in the Module 06 manual.

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:

Table: Flag, Meaning
FlagMeaning
In stockEnough is available.
Short 4Not enough anywhere; 4 more are needed.
Below minimum afterApproving leaves the ordering location under its minimum.
Over maximum afterApproving takes it over its maximum.
Not in catalogueAn 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

Table: Button, What it does
ButtonWhat it does
ApproveAsks for Approval notes (optional) and records your approval. If your workspace set a reminder for approvers, it shows above the box.
Adjust itemsTrim quantities or remove lines without rejecting. See below.
Review sourcingSupply requests, for approvers who also fill supply requests: raise the transfers and purchase orders now. Filled when a line needs a decision.
RejectRequires a Rejection reason. The request ends as Rejected.
ReturnSends 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.

Admin & manager note

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.

If the page cannot tell whether you are the approver

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

Section 17 · Approving · 4 min
Goal: Work through everything waiting for your decision from one list.

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.

Table: Column, What it shows
ColumnWhat it shows
Request #The number.
TypeSupply, Purchase, Transfer or Return. These are the built-in names, not your workspace's labels.
RequesterWho raised it.
CreatedWhen it was created.
PriorityLow to Urgent.
Current stepStep number and how the step decides.
ActionsOpen, 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.

Approving from the list skips the review panel

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.

Admin & manager note

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

Section 18 · Filling requests · 10 min
Goal: Source an approved supply request from stock, by transfer or by purchase order, and correct it before anything is sent.

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:

Screen recording: creating a stock transfer to fill an approved supply request
Watch it done (1.5 minutes). Covering an approved supply request from stock you already hold, and how the transfer links back to it. The walkthrough recording is in the Module 06 manual.
Table: Field, What it shows
FieldWhat it shows
DestinationThe location it is for.
Requested on behalf ofThe person, if given.
Reason givenThe requester's notes, or None — the requester left the notes empty.
SourcingLines decided so far: 2 from stock · 1 bought in · 3 not decided.
CoverageA 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:

Table: Button, What it does
ButtonWhat it does
Create Transfer for 3 available itemsMakes 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 itemsMakes 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 StockSets stock aside straight away from a location you can issue from.
Edit itemsCorrect the request before anything is sent or ordered.
Mark FulfilledShown when Tansi offers it for the request's state.
ReceiveFor 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

  1. Pick the Line (each shows what remains).
  2. Pick From location: only places you can issue from that hold the item, closest first, with the quantity available.
  3. Enter the Quantity. The helper says the most you can take: what the line needs or what the location has.
  4. 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.
  5. 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

Section 19 · Filling requests · 10 min
Goal: Send an approved purchase order to the supplier, record its finance details and follow it through to receipt and close.

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.

Table: Button, What it does
ButtonWhat it does
Send to Vendor / Resend to VendorAlso 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 SentYou 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 PORecord 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 ContractChange 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 CodingAccount, 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 ConfirmationThe supplier confirmed the order.
Update ETAChange the Expected Delivery date and Save ETA.
Email APOnly when accounts payable has an email set. Asks Send Purchase Order … to …?.
Send Receiving ConfirmationEmails 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 itemsOpens receiving for the lines still outstanding.
Close Purchase OrderCloses the order when Tansi offers it.

Once sent, Download Purchase Order PDF gets the same document again for printing or forwarding.

Orders that go through the finance system

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

Section 20 · Filling requests · 9 min
Goal: Pick, ship, send back, receive and close transfers and returns, and print a return label.

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

Table: Button, Who sees it, What it does
ButtonWho sees itWhat it does
Pick & shipWarehouse staffOpens the warehouse work order, where the source lot is picked and the shipment recorded.
Send it backOn a return to the warehouse, for people at the returning location who do not fill transfersShips 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 returnOn a supplier returnShips 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.

What the return label does not do

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

Section 21 · Purchase order finance · 9 min
Goal: Attach a supplier invoice to a purchase order, match it against what was ordered and received, and send it to accounts payable.

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

  1. Press Attach invoice.
  2. Enter the Invoice number (required or optional, as your workspace sets it).
  3. 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.
  4. Choose the scan of the invoice (required or optional).
  5. Press Attach invoice.

Invoice statuses and buttons

Table: Status, Meaning
StatusMeaning
AttachedAdded, not yet matched.
Being matchedA matching draft is saved.
On holdNothing is paid until it is re-opened.
Waiting for approvalAccepting created something (a revision) that needs approval first.
Approved for paymentReady for accounts payable.
Sent to APHanded to accounts payable.
CancelledWithdrawn.

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.

Separation of duties

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

Section 22 · Purchase order finance · 5 min
Goal: Send received items back to the supplier from a purchase order and record the replacement or credit.

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.

Table: , Return to vendor (on the PO), Supplier Return request (RTN-)
Return to vendor (on the PO)Supplier Return request (RTN-)
WhereA card on the purchase order's pageIts own request, raised from New request
ApprovalNone: it starts at onceGoes through its approval route
StockHeld where it is until marked shipped backLeaves when the return is shipped
Best forSomething that arrived wrong on this orderStock 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

  1. Press Return to vendor.
  2. Choose the PO line (each shows how many were received).
  3. Enter the Quantity going back, up to what is received and not already going back.
  4. Pick the Reason: Wrong item, Damaged, Failed quality check, Expired or Other.
  5. 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).
  6. Add the Vendor RA number (optional) and Why it is going back (required).
  7. Press Return to vendor: The return is started. The stock is held until it is shipped back.

Following it through

Table: Status, Next step
StatusNext step
RequestedMark it shipped back: optional Carrier and Tracking number, then Mark shipped back. The stock leaves now.
Shipped backFor a credit, enter the credit note. For a replacement, receive the new delivery.
Credit received / Replacement receivedDone.
CancelledWithdrawn 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

Section 23 · Request tools · 8 min
Goal: Find any fact about a request on its page: who, where, what happened, what is attached and what it is linked to.

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.

A Tansi supply request showing the five-stage progress bar at step 5 of 5, its lines, supply details, approvals with named approvers, and linked requests
A request, open. The five-stage bar across the top is the heart of it. Below: the lines, where it's going, who approved it and when, and any linked requests filling it.

The header

Table: Part, What it shows
PartWhat it shows
Number and chipsThe 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 byThe requester of record.
Requested on behalf ofThe person it is for, when given.
Delivery addressWhen one was entered (not on returns).
Need byOr Not set.
ProjectOr None.
Barcode and QR codeThe barcode carries the request number for scanners; the QR code opens the request.
Print iconPrint preview of the whole request.

Banners you may see

Table: Banner, Meaning
BannerMeaning
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 categoryLinks 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 shortfallSome lines had no stock at submit.
Shipped … Carrier … Tracking … ETA …The latest shipment, with Reprint packing slip.
Not-allowed item override on this requestLines added against the destination's not-allowed list, with the reason, who and when.

Right-hand panels

Table: Panel, What it holds
PanelWhat it holds
ProgressRoute, approval steps and the milestones after approval.
Procurement timelinePurchase orders only, folded.
AssignmentWho owns the work, with its history. Reassigning reloads the page.
Linked requestsThe 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 activityEvery 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).
AttachmentsPick 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 fieldsValues captured by your workspace's forms, or No custom field values captured for this request.
Deleting an attachment is immediate

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

Section 24 · Request tools · 7 min
Goal: Use the request lists, their filters and exports to find any request quickly.

There are six lists, all opened from the hub:

The All Requests list with search, type, stage, priority, raised-by and site filters above a table of requests with stage and fulfillment
All requests. Filters across the top, then one row per request with its stage, fulfillment, priority and dates. A lock chip marks a request with a controlled line.
Table: List, What it holds
ListWhat it holds
My RequestsTwo 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 RequestsEvery kind together.
Supply RequestsSupply Requests from the field. Adds a Requesting Location column.
Stock TransfersStock Transfers between locations. Adds Direction (Incoming, Outgoing or Within your sites) and From → To; each row expands to show its lines.
Purchase OrdersPurchase Orders sent to vendors. Shows Supplier.
ReturnsBoth 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

Table: Filter, What it does
FilterWhat it does
Search or scanNumber, item, notes or barcode. Scan a label (or type at least four characters and press Enter) and a matching request opens directly.
TypeAll types or one kind (not on the single-kind lists).
StageAll stages, or Draft, Pending approval, Approved, Rejected, Active, Completed, Cancelled.
PriorityAny, or Low to Urgent.
Raised byAnyone, or one requester (not on My Requests).
SiteRequests for one location.
Created from / Created toA date range.
Critical line onlyRequests with at least one critical item.
Assigned to meRequests 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.

Scanning paperwork

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

Section 25 · Request tools · 6 min
Goal: Create, use, clone and maintain templates for orders you place again and again.

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

Table: Column or icon, What it means
Column or iconWhat it means
NameWith the description underneath.
TypeSupply, Purchase, Transfer or Return (built-in names).
ScopeTenant (your workspace) or Global (shared across the platform).
PriorityWorked out from the lines.
Created byWho made it.
Use templateCreates 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.
EditYour workspace's own templates.
Clone to my tenantGlobal templates: copies it into your workspace and opens the copy.
DeleteAfter 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:

Table: Field, What to know
FieldWhat to know
Name (required)Up to 200 characters.
Priority (auto-derived from lines)Read-only.
DescriptionUp to 1000 characters.
TypeCannot 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.
ItemsAdd line: Item description, Quantity, Unit of measure, Priority.

Press Save template.

The template editor keeps only text on each line

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

Section 26 · Request tools · 5 min
Goal: Build a supply request from a CSV or Excel file and submit it, or review it first.

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.

Supply requests only

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

  1. 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.
  2. 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.
  3. 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

Table: Button, What it does
ButtonWhat 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 firstOpens the draft in the editor (one draft only).
Import another fileStarts 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

Section 27 · Use cases · 8 min
Goal: Follow three realistic requests from the first search to a submitted request.

1. A site foreman needs harnesses (construction)

  1. On the hub, press New Request and type harness in Search item.
  2. 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.
  3. Requested for location is already North Site Office, because he is assigned to that site only.
  4. In Add an item by name or SKU he adds the harness, sets Qty to 6, and adds two lanyards with Browse catalogue.
  5. In Notes for the approver: Two new hires start Monday; scaffold work on level 3.
  6. 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)

  1. The office manager exports her usual stationery order to a CSV: item, quantity, unit.
  2. On the hub she presses Import CSV, uploads the file and answers the questions the import raises.
  3. 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.
  4. The order is a week early, so Tansi asks for a Reason for ordering ahead of schedule: Quarter-end mailing.
  5. 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)

  1. At the nursing station, signed in on the shared station account, a nurse opens New Request › Supply Request.
  2. The location is filled in. Requested on behalf of is required on this account, so she picks herself from the people at this location.
  3. The location only accepts template items, so she picks the Weekly dressings template and presses Load template items. Tansi adds 14 lines.
  4. 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.
Not limited to medical use

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

Section 28 · Use cases · 8 min
Goal: Follow a supply request through approval and sourcing, from both the approver's and the storeroom's side.

1. An approver trims an order (events)

An events company's venue store asks for 60 radios and 60 headsets for a weekend festival.

  1. The operations manager sees it in Awaiting my approval on the hub and presses Review.
  2. 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.
  3. She presses Adjust items, sets headsets to 40, writes Venue max is 70 in Why, and presses Apply 1 change(s).
  4. 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)

  1. The storeroom lead opens Supply Requests to fill on the hub and picks the request (Not started).
  2. Coverage reads 0 of 100 units covered — nothing set aside yet.
  3. 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.
  4. Tansi allocates the 30 and opens a draft purchase order for the other 30, already linked. She picks the supplier and submits it.
  5. For the headsets, Create Transfer for 1 available item opens a draft transfer from the satellite store; she checks the source and submits it.
  6. 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

Section 29 · Use cases · 9 min
Goal: Follow a purchase order from draft to invoice, and two returns from start to finish.

1. Ordering lumber with freight (construction)

  1. 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.
  2. She adds three more items with Browse catalogue; the supplier's items are listed first.
  3. Under Extra costs she presses Add extra cost: Shipping / freight, Flatbed delivery, $180, taxable, with the provincial sales tax.
  4. 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.
  5. Once approved, she presses Send to Vendor, attaches the quote and presses Send.
  6. 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)

  1. On the purchase order, under Returns to the vendor, the receiver presses Return to vendor.
  2. 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.
  3. When the carrier collects the box, she presses Mark shipped back on the return and adds the tracking number.
  4. The replacement delivery is received against the same order and closes the return.

3. Expired stock goes back to the warehouse (events or clinic)

  1. At a satellite store, a coordinator opens New Request › Return and picks Back to the warehouse.
  2. Returning from is her store; Send it back to lists the warehouse that supplies it.
  3. She adds the items from what the store holds and sets each Reason to Expired.
  4. 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.
Not limited to medical use

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

Section 30 · Warehouse and receiving · 7 min
Goal: Use the Warehouse Queue to see what has to be picked, packed and shipped, and what is arriving from vendors, and spot what is late or urgent.

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.

The Warehouse Queue with ten counter tiles, filter chips and the internal work list of transfers with stage and picked counts
Warehouse Queue. The tiles count open work, picking, ready to ship, overdue, returns, restricted and critical work. Each row opens the work order.

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.

What the queue shows you

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

Table: Filter, What it does
FilterWhat it does
All, Standard transfers, Returns, Critical, RestrictedChips 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.
LocationA 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 priorityShow only work at this priority or higher: Low, Normal, High or Urgent.
StageShow 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.

Table: Column, What it tells you
ColumnWhat 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.
DateWhen the request was raised.
Type, Priority, StageChips for the request type, its priority and where it is in pick, pack and ship.
Need ByThe date it is needed. Red when it is overdue.
From / ToWhere the stock leaves from and where it goes.
ItemsHow many lines the request has.
PickedUnits 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 #.

Table: Column, What it tells you
ColumnWhat it tells you
Vendor, Ship ToWho is sending it and which of your locations receives it.
Priority, Sent, ETAThe priority, the date it went to the vendor and the expected delivery date. The ETA turns red when it has passed.
ItemsHow many lines are on the order.
ShipmentsA 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.

Read the Picked fraction

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

Section 31 · Warehouse and receiving · 10 min
Goal: Pick a work order line by line or all at once, choose the right location and lot, and deal with shortages and mistakes.

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.

Screen recording: picking, packing and shipping a transfer from the warehouse queue
Watch it done (2 minutes). The warehouse side — picking the lines, packing them and marking the shipment out. The walkthrough recording is in the Module 06 manual.

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

Table: Column, What it is for
ColumnWhat it is for
ItemName, unit and handling chips. A Needs you flag appears here after Record all skips a line.
SKU / BarcodeTo check against the shelf label.
PriorityThe line's own priority. A warning at the top tells you to pick lines flagged above the request's priority first.
Requested / PickedWhat was asked for and what is picked so far. Picked turns green when the line is complete.
Location and LotWhere you are taking it from and, for lot-tracked items, which lot. See below.
AvailableStock at the chosen location. Amber when there is not enough; +N elsewhere shows stock at other locations.
QuantityHow many you are picking now. Only N available here warns you when you type more than the shelf holds.
Record / ResetRecord 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.

Complete picking needs every line fully picked

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

Section 32 · Warehouse and receiving · 7 min
Goal: Pack picked goods into boxes or bags with their own slips, ship them with a carrier and tracking number, and go back a step when something is wrong.

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

  1. Read the status line, for example 0 of 36 units packed.
  2. 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.
  3. Adjust Qty in this box if only part of a line goes in this container. It starts at the remaining quantity.
  4. Choose the Container type and, if useful, add Container notes (optional) such as keep cold, fragile (up to 500 characters).
  5. Press Add followed by the container type and number, for example Add box 1. Tansi confirms that the container is packed.
  6. 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

Table: Field, What to enter
FieldWhat to enter
CarrierRequired. 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.
ETAWhen 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.

Admin & manager note

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

Section 33 · Warehouse and receiving · 10 min
Goal: Receive the goods on a purchase order, transfer or return: record what arrived, what was short or damaged and why, enter lots, and close a request whose shortfall is final.

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.

Screen recording: receiving a shipment against a request and closing it out
Watch it done (2 minutes). Receiving what arrived, and the request moving to Completed. The walkthrough recording is in the Module 06 manual.

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

Table: Control, What it does
ControlWhat it does
Apply picksOnly 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 allFills each ticked line with its full outstanding quantity.
Scan boxScan 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.
PODAttach 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 filledProgress.
N need attention · NextAppears when lines are incomplete; each press jumps to the next one. Show only these hides the finished lines.
Cancel / Confirm receiptLeave 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.

Table: Field, What it is for
FieldWhat 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.
ReasonRequired when you receive less than outstanding or record any damage: Damaged, Short shipped, Missing, Wrong item, Failed quality check, Expired or Other.
NoteAnything 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 intoThe 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 and the button disagree

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

Section 34 · Warehouse and receiving · 9 min
Goal: Follow four real jobs from start to finish: a construction-site transfer, an event kit packed in several boxes, a vendor delivery with a short line, and a clinic restock.

1. Construction: tools to a site, picked by scanner

  1. 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.
  2. The storekeeper filters Location to the yard, opens the order and presses Start picking. The order is now locked to them.
  3. 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.
  4. 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.
  5. Complete picking, then Mark packed (one load, no containers).
  6. 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

  1. An event coordinator's supply request for badges, lanyards, extension cords and signage is approved.
  2. 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.
  3. 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.
  4. 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

  1. Paper, toner and chairs arrive for a purchase order. Reception opens it from the External list and presses Receive items.
  2. In Receipt paperwork they type the packing slip number and add the freight charge with Add extra cost.
  3. 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.
  4. They photograph the signed delivery note with POD, then press Confirm receipt.
  5. 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

  1. 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.
  2. The vaccine is packed in a cooler box with Container notes "keep cold" and shipped.
  3. 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.
  4. 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.
Not limited to health care

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

Section 35 · Stock on hand · 9 min
Goal: Read on hand, reserved and available for every item, filter the list to what you need, and know which action buttons you will see.

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 Stock and Assets page with action buttons, search and filters, and the stock levels table with on hand, reserved, available, min and max, locations and status
Stock & Assets. Action buttons across the top, filters below, then one row per item with on hand, reserved and available.

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

Table: Column, What it means
ColumnWhat it means
On HandEverything physically in your locations.
ReservedThe part of on hand already promised: held for an approved request, or held because it was received without a purchase order number.
AvailableWhat you can actually use. It shows in red when it is zero or less.
On hand is not what you can use

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

Table: Status, When it shows
StatusWhen it shows
UnavailableSomething is on hand, but nothing is available: it is all reserved or held.
Out of StockNothing on hand and nothing available.
Low StockAvailable is at or below the item's reorder threshold.
In StockAnything 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.

Table: Button, What it does, Who sees it
ButtonWhat it doesWho sees it
Withdraw SuppliesOpens 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 requestFind 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 receiptsThe queue of deliveries received without a Tansi purchase order or transfer.Editors of stock tracking
Move stockMove stock between storage spots inside one location, at once.Editors of stock tracking, and anyone allowed to move stock
TransferStarts a new transfer request to another location.Editors who may raise transfers
AdjustCorrect a quantity, with a reason.Editors of stock tracking

Filters

Table: Filter, What it does
FilterWhat it does
SearchItem name, SKU, description or lot. The list updates when you finish typing and press Enter, not on every key.
CategoryOne category.
DepartmentOnly appears when the listed items belong to departments. No department finds items that have none.
LocationA searchable tree. Choosing a place includes everything stored inside it.
StockAll 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.
FlagsAll items, Controlled (items marked restricted), Critical or Hazardous.
RefreshReads the numbers again.
Stock LedgerOpens 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.

Arriving from an item

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.

Why a child item seems to be missing

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

Section 36 · Stock on hand · 8 min
Goal: Open an item's stock by location and lot, read lot holds and multi-dose columns, use the row icons, and read the Assets tab.

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

Table: Column, What it shows
ColumnWhat it shows
LocationThe path to the place, shortened if long; hover for the full path. A storage area such as a shelf or bin shows underneath.
LotThe lot number and exp date (red once expired). A dash means the item is not lot-tracked.
SKUThe full SKU, wrapped rather than cut off.
On Hand, Reserved, AvailableFor that place and lot.
UpdatedWhen that line last changed.
Table: Lot chip, Means
Lot chipMeans
QuarantinedHeld back pending investigation.
RecalledWithdrawn by the manufacturer or a regulator.
SuspendedTemporarily not to be used.
Held and expired lots count as zero available

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

Table: Icon (tooltip), What it does, Who sees it
Icon (tooltip)What it doesWho sees it
Create purchase requestStarts 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 availableOpens Alternatives for ....Items with alternatives set
View itemA quick-view panel with the item's details. Its own buttons follow your Item Master rights.Everyone
Edit itemOpens 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

Table: Column, What it shows
ColumnWhat it shows
Item, SKU, Asset Code, Serial #, Category, LocationIdentification and where it is.
StatusOnline (green), Offline (red), Standby (amber) or DoNotTrack.
CriticalityCritical, Important or Normal.
Last Serviced, Next ServiceNext 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.

Only Search and Category filter the Assets tab

The Department, Location, Stock and Flags filters apply to the Stock Levels tab only.

Reserved Stock

Section 37 · Stock on hand · 6 min
Goal: See which stock is being held, what holds it, and spot holds nobody can explain.

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.

Reserved Stock with tiles for reserved rows, units reserved, items affected and no identifiable holder, above a table of held stock and the requests holding it
Reserved Stock. Every held row and what is holding it. The last tile should read 0: every hold explained.
The purchase order label is yours

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

Table: Figure, What it counts
FigureWhat it counts
Reserved rowsItem × location × lot rows with something held.
Units reservedThe total held.
Items affectedDistinct items.
No identifiable holderRows 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:

Table: Chip, Means
ChipMeans
Awaiting External POReceived without a purchase order number and held until one is added.
N unexplainedReserved units no open request accounts for.
No open requestNothing 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.

There is no release button for a stale request hold

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

Section 38 · Stock on hand · 6 min
Goal: Keep watch on items that must never run out and on restricted items: stock health, days of cover, what is on order and who to call.

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.

Critical Items with tiles for critical and restricted items, stocked out, below minimum, below reorder and expiring, filter chips and the item table
Critical Items. Items that must never run out, with days of cover, what is on order and the supplier's lead time.

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

Table: Column, Shows
ColumnShows
StatusStocked out, Below minimum, Below reorder or OK.
ItemPicture, SKU, unit, category, and chips saying why it is listed: Critical, Restricted, or Family of N for a generic parent.
On handTotal across locations, with what is available and held.
Min / Reorder / MaxThe 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 coverHow 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 orderQuantity on open purchase orders and how many. nothing on order in amber when the item is short.
Soonest expiryThe first lot to expire, expired N days ago, expires today, expires tomorrow or in N days.
SupplierWho 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.
LocationsHow 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.

Admin & manager note

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.

Not only for clinics

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

Section 39 · Stock on hand · 5 min
Goal: Work through stock situations flagged from the Tansi Inventory app and record what you found.

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?

Stock Review with the count variance thresholds, type, status and location filters, and an empty flags table
Stock Review. Set the variance thresholds at the top; flags land in the table below.

The three kinds of flag

Table: Kind, Raised when
KindRaised when
Negative stockA movement took a place below zero.
Held stock takenSomeone took stock that was reserved. The Held for link under the reference opens Reserved Stock.
Count varianceA 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

  1. Select Resolve on an open flag.
  2. In Resolve flag, write a Resolution note: Say what you found or did. It is required, up to 1,000 characters.
  3. Select Mark resolved. Tansi says Flag resolved.
Resolving does not change stock

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

Section 40 · Moving, counting and correcting · 9 min
Goal: Move stock between shelves, bins, fridges and carts inside one location, at once and with no approval.

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.

Move Stock in three steps: choose the location, add the items to move, and confirm the move with an optional reason
Move Stock. Shelf to fridge, bin to cart: inside one location only, with no 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.

Admin & manager note

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:

Table: Part of the line, What to do
Part of the lineWhat to do
Coming fromWhere 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 toThe 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.
QuantityFor items without lots, a number on the line, up to what is at the source.
Lots to moveFor 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 destination? Enable storage first

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

Section 41 · Moving, counting and correcting · 6 min
Goal: Correct a quantity with a reason, handle lots when adjusting, and reassign stock to a different storage area.

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

Table: Field, What to enter
FieldWhat to enter
Scan / Enter BarcodeOptional. A scan picks the item; a GS1 barcode that carries a lot also picks the lot. Tansi says Found: ....
ItemRequired. Generic parent items are not offered: adjust the product itself. Inactive items appear only for people allowed to work down inactive stock.
LocationRequired.
Storage Area (optional)For example Shelf A or Bin 3.
Adjustment QuantityPositive to increase, negative to decrease.
LotsFor 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.

Admin & manager note

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

Section 42 · Moving, counting and correcting · 9 min
Goal: Load the expected stock for one or more locations, scan or type what you find, and read the differences.

Stock › Inventory Count: Scan items to verify stock levels. Differences are shown for review before applying adjustments. Nothing changes until you choose to apply.

Inventory Count asking for the count locations before any items are scanned
Inventory Count. Choose the locations first; everything stored inside them is included.
A count lives on the page until you apply it

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

  1. Pick one or more places in Count locations. Each pick counts itself and everything stored under it: a site, its rooms and their shelves.
  2. Tansi loads every stock row there straight away: Loaded N stock row(s). If stock moves while you count, select Reload Expected Stock.
  3. 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

Table: Column, What it shows
ColumnWhat it shows
ItemWith the place under it when the count covers several.
SKU
Lot / ExpiryOne 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 HandThe total across all locations, colored when below the minimum, at the reorder point or over the maximum. Hover for which.
Levelsmin, max and thr (reorder threshold) for the counted place or the site it sits in.
ExpectedOn hand at the counted place when the count was loaded.
CountedWhat you found. Whole numbers. Blank means not counted yet.
DifferenceGreen for over, red for short. A dash means nothing entered.
ReasonWhy 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.

Blank is not zero

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.

Not only for clinics

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

Section 43 · Moving, counting and correcting · 7 min
Goal: Give every difference a reason, decide about zero counts, apply the adjustments, and quarantine or return a lot you find during the count.

Reasons

Pick a reason on each line, or set a Default reason in the header for any line without its own.

Table: Reason, Use it for
ReasonUse it for
MiscountThe last count was wrong.
Data entry errorSomeone typed the wrong figure.
Unrecorded receiptStock arrived but was never booked in.
Unrecorded issue / usageStock was used but never withdrawn in Tansi.
DamagedBroken stock found. Also recorded as waste, reason Damaged.
ExpiredExpired stock removed. Also recorded as waste, reason Expired.
Lost or stolenGone without explanation.
FoundMore than expected turned up.
Transfer not recordedStock was moved without a transfer or move.
OtherAnything else.

Applying

  1. Turn on Include zero counts only if lines you counted as 0 really should be written down to zero.
  2. 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.
  3. 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.
  4. 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.

Admin & manager note

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:

Table: Menu item, What it does
Menu itemWhat it does
Mark quarantined, Mark recalled, Mark suspendedFor 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 warehouseFor people allowed to raise returns: starts a return transfer for that line, pointed at the warehouse this location orders from.
Remove from countDrops the line from this count.

The Stock Ledger

Section 44 · Moving, counting and correcting · 6 min
Goal: Find any movement of stock, read the running balance, and report an incident against a removal.

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

Table: Column, What it shows
ColumnWhat it shows
DateWhen it happened.
TypeReceive (green), Issue (amber), Transfer (blue), Adjustment (gray) and other types.
ItemWith SKU, and Child of ... for a product under a generic item.
Lot
In, OutThe quantity in or out.
BalanceThe running balance after this row, for the item and location you filtered on.
MovementFrom where to where. External / origin means it came from outside; Issued / consumed means it left stock.
Recorded byThe person who did it.
ReasonHover for the full text: count reasons, waste reasons, who a withdrawal was for.
ReferenceThe 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

Section 45 · Withdrawing supplies · 9 min
Goal: Set up the working bar, find a supply by search, scan, view or lot, and read the side panels.

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.

Withdraw Supplies with the working location, user account and withdrawing-for fields, area chips, the Available supplies, Dispensing and Waste tabs, product cards and the Open now panel
Withdraw Supplies. Where you are, who you are and who it is for, then the products held here. Each card has Withdraw and, for multi-use items, Dispense.
The working location picker open, listing top-level locations with their stock counts and kinds
Choosing the working location. Type to filter, or open a site to see what is inside it. Tansi remembers the choice on this device.
Admin & manager note

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.

Called Dispense? It is not only for medical supplies

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

Table: Field, What it does
FieldWhat it does
Working locationWhere 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 accountThe 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 forThe 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

Table: Tab, What it shows
TabWhat it shows
Available suppliesEverything usable at this location, with a count.
DispensingEvery multi-dose unit that has been opened, each with its own clock. See Dispensing: opening a unit and its clock.
WasteEverything 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

Table: View, What you get
ViewWhat you get
CardsA 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.
GridProduct, SKU, Category, Available, Recommended lot, Doses (10 per vial, 6 h once opened, or single), Actions.
KanbanA column per category with product and on-hand counts; fold a column by its heading.
Lot numbersEvery 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

Section 46 · Withdrawing supplies · 6 min
Goal: Withdraw a supply from the right lot and place, and understand what Tansi records when you choose a different lot.
  1. Choose the Working location, and the account and name if they are not you.
  2. 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.
  3. If the item is restricted or high-risk, read the warning and select Acknowledge.
  4. 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.
  5. Enter How many — whole numbers, at least one, no more than that lot holds in that place.
  6. 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.

The Withdraw dialog with the recommended lot, the quantity and a summary of what will be left
Withdraw. The earliest-expiring lot is chosen for you. Choosing another is allowed and recorded.

Messages you may see

Table: Message, Means
MessageMeans
At least one is neededThe quantity is zero or blank.
Only N left on lot X in YTake 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.
Taking a different lot is allowed — and recorded

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.

Not only for clinics

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

Section 47 · Multi-dose items & dispensing · 8 min
Goal: Set up an item that holds several doses or uses — a vial, a bottle of tablets, a box of swabs — so it can be dispensed and its expiry after opening is enforced.

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.

Withdraw Supplies filtered to suppositories, with cards showing how many doses each unit holds
Multi-dose products. Each card says how many doses a unit holds, for example 12 doses a unit. The same works for any product used a little at a time.

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.

Dispensing is not only for medical supplies

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

Table: , Contains multiple units — ON, Contains multiple units — OFF, uses above 1
Contains multiple units — ONContains multiple units — OFF, uses above 1
Also calledContainer modeUses mode
Stock is counted inThe doses or units inside — a vial of 10 counts as 10Whole units on the shelf — a bottle counts as 1
Receiving is entered inContainers (vials, boxes) — Tansi multipliesWhole units
FieldsContainer name, Units / uses per container, Expires after opening (hours), Generate a barcode for each received containerUses / doses per unit
Opening oneStarts 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 openingYes — the hours you setNo — the clock runs to the lot's expiry date
Each container trackedYes, with its own barcode if you chooseOnly once opened
Typical forMulti-dose vials, items that spoil once opened, anything you count by the doseBottles of tablets, tubes, boxes of swabs counted as boxes
Need an expiry after opening? Use container mode

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

  1. Open the item in Item Master and go to Packaging, Storage & Stock.
  2. Turn on Contains multiple units.
  3. Enter the Container name in the singular — vial, box, package. It is the word Tansi uses on every screen (Open one vial).
  4. Enter Units / uses per container — how many doses one container holds.
  5. 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.
  6. Leave Generate a barcode for each received container ticked to label every container on receipt, so each vial can be scanned and traced.
  7. 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

Table: Where, What changes
WhereWhat changes
ReceivingIn 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 listA child item shows 10 per vial (container mode) or 100 uses per unit (uses mode).
Stock LevelsThe location table names the unit in its headings and adds a Uses or ≈ vials column.
Withdraw SuppliesThe Dispense button is enabled. Cards show how many doses a container holds, and the grid shows the hours allowed once opened.
ScanningA container barcode identifies that exact container.
Barcodes on packages and units

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

Section 48 · Multi-dose items & dispensing · 8 min
Goal: Open a multi-dose unit, understand which clock it is on, and read the countdown on the Dispensing tab and the Open now panel.

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 Open one dialog for a product, showing doses per unit, the recommended lot, a tracking note and when the unit's clock runs out
Opening a unit. One unit comes off the shelf and its clock starts. With no in-use window set, the clock runs to the lot's expiry.
The Dispensing tab showing an open unit with its countdown, holds, used and left counts, and the Dispense doses and Waste buttons
The Dispensing tab. Each open unit shows its own clock and dose count, with Dispense doses and Waste.
Not only for medications

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.

Dispense is grayed out?

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

  1. Select Dispense on the product. A generic item first asks which product. A dialog titled Open one … appears.
  2. Read the blue banner: how many doses the product holds and, if set, how many hours it must be used within.
  3. 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.
  4. 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.
  5. 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.

Stock from before container tracking

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:

Table: Clock, Set by, What happens when it runs out
ClockSet byWhat happens when it runs out
In-use windowExpires after opening (hours) on the item, starting when the unit is openedDispensing stops, and the doses left are written off automatically as waste, reason Expired after opening.
Product (lot) expiryThe expiry date of the lot you openedDispensing stops. Record the doses left as waste yourself, reason Expired.
No clockNeither is recordedThe 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.

Table: Chip on the card, Means
Chip on the cardMeans
In useSeven days or more left, or no clock.
Expires this weekLess than seven days left.
Use it or lose itLess than 24 hours left.
ExpiredThe 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.

The Open now panel

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

Section 49 · Multi-dose items & dispensing · 7 min
Goal: Record each dose given from an open unit, and record doses that were lost — for one reason or several.
Not only for clinics

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

  1. On the Dispensing tab, find the unit and select Dispense doses.
  2. Check the banner: the time left on the unit and when it closes.
  3. 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.
  4. Choose Given to from the list of accounts. It starts on the account in the working bar and must be filled in.
  5. Add a Note if useful (up to 300 characters).
  6. Check the summary — how many would be left — and select Record the doses.
No patient names or health information

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.
Once a unit has expired, Dispense doses is disabled

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.

The Dispense doses dialog with doses given, given to, a note, and a summary of doses left and time remaining
Dispense doses. Enter the doses given and who received them. The summary shows what will be left and how long the unit has.
The Record waste dialog with doses, reason and note lines, an Add another reason button and a total
Record waste. Doses can be lost for more than one reason, so add a line for each.
  1. Enter the number of Doses on the first line.
  2. Choose a Reason and add an optional Note (up to 300 characters).
  3. Select Add another reason for a second line if some were lost differently. Remove drops a line.
  4. Check the total — 3 doses across 2 reasons, leaving 5 in the unit.
  5. 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.

Table: Reasons you can choose,
Reasons you can choose
ExpiredThe product itself passed its expiry date.
Cold chain / temperature excursionStored outside its temperature range.
DamagedBroken, cracked, punctured.
SpoiledGone off and no longer usable.
RecallWithdrawn by the manufacturer or a regulator.
QuarantinedHeld back pending investigation.
ContaminatedContaminated before or during use.
DiscardedThrown away by choice.
OtherAnything else — explain in the note.
Expired after opening is not in the list

That reason is written only by the expiry clock. If the product's own date has passed, choose Expired.

The Waste tab

Section 50 · Multi-dose items & dispensing · 5 min
Goal: See everything thrown away at a location, filter it, export it and open any entry.

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 Waste tab with totals for doses discarded, lost to expiry, recorded by a person and commonest reason, filters, and the note that clock waste cannot be deleted
The Waste tab. Everything thrown away at this location, and whether a person or the clock recorded it.
Not only for clinics

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

Table: Figure, What it counts
FigureWhat it counts
Doses discardedAll doses written off here, and how many entries.
Lost to expiryDoses written off by the clock, and how many of the entries that is.
Recorded by a personDoses somebody recorded.
Commonest reasonBy 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.

Waste written by the clock cannot be deleted — and expired units take no more doses

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

Section 51 · Multi-dose items & dispensing · 4 min
Goal: Know exactly what Tansi does when an open unit expires, and where to see what was written off.

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.

Not only for clinics

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.

Table: Which clock ran out, What Tansi does, What you do
Which clock ran outWhat Tansi doesWhat you do
In-use windowWrites 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) expiryBlocks 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 leftCloses the unit. There is nothing to write off.Nothing.
Why a unit can still show doses right after it expires

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.

Record every dose at the time you give it

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

Section 52 · Multi-dose items & dispensing · 10 min
Goal: Follow complete, real-world examples from setting up an item to throwing the last of it away.

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.

Dispensing is not only for medical supplies

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.

  1. 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.
  2. Receive. A delivery of 20 vials is received as 20 vials; 200 doses go into stock, each vial with its own barcode.
  3. 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.
  4. 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.
  5. A dose is dropped. She selects Waste, enters 1, reason Damaged, note dropped while drawing up.
  6. 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.
  7. 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.
Plan the clinic around the clock

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.

  1. Set up once. Leave Contains multiple units off and set Uses / doses per unit to 100.
  2. 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.
  3. Give doses. Select Dispense doses and enter 2 for a two-tablet dose. Stock does not change; the bottle's Left count does.
  4. 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.

  1. Turn on Contains multiple units: container name box, 12 per container, and leave Expires after opening empty.
  2. Receive boxes; stock is counted in cans.
  3. 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

  1. The clinic signs in once on a shared station account.
  2. 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.
  3. 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.

  1. 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).
  2. When a drum is started, the caretaker selects Dispense on it at the closet location.
  3. Each night shift records Dispense doses for the buckets mixed, Given to the night crew's account.
  4. 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

  1. At the end of the week the clinic lead opens the Waste tab for the clinic fridge.
  2. She sets Recorded by to The clock to see only the doses lost to expiry.
  3. She selects View on an entry to see the product, lot, doses, reason Expired after opening and when it was written off.
  4. 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

Section 53 · Withdraw for Delivery · 6 min
Goal: Know when to use Withdraw for Delivery, read its statuses and find a withdrawal.

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.

Withdraw for Delivery with status chips, a search box and a table of withdrawals with deliver to, from, requester, creator, dates and next step
Withdraw for Delivery. Each row says what happens next, for example Pick, then record the shipment.
Admin & manager note

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

Table: Situation, Use
SituationUse
A department with no Tansi users asks for supplies by emailWithdraw for Delivery
A site that receives its own stock in Tansi needs suppliesA transfer request, so the stock lands in their stock when they receive it
Someone takes supplies off the shelf in personWithdraw Supplies

Statuses

Table: Status, Means, Next step shown
StatusMeansNext step shown
DraftTyped in, saved. No stock taken yet.Pick, then record the shipment
ShippedThe shipment is recorded and the stock has left the warehouse.Confirm the delivery
DeliveredThe department confirmed it arrived.Review and close, or Resolve the discrepancy, then close
ClosedFinished; kept with its documents for audit. Cannot be changed.—
CancelledCanceled 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.

Not only for clinics

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

Section 54 · Withdraw for Delivery · 10 min
Goal: Type in an emailed request, build the pick list, fix shortages and record the shipment.

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

Table: Card, Fields
CardFields
Sent fromWarehouse (required). Stock stored anywhere inside it counts: shelves, bins, fridges. Notes (optional), Printed on the withdrawal report.
The request as emailedRequested by, Department (from your workspace list; you can add one), Email, Phone, Request received (date), Email subject or reference.
Deliver to requiredChoose 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.

The place receives in Tansi? Make it a transfer

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.

Table: Column, What it is
ColumnWhat it is
ItemWith a note icon for a Note for the picker or the department.
AvailableWhat the warehouse holds.
RequestedWhat the email asked for.
SendWhat you will actually send; 0 if none.
LotAuto (soonest expiry) or a specific lot.
Pick fromWhere 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

Table: Button, What it does
ButtonWhat it does
Save draftSaves it and gives it a number. No stock was taken. Your workspace may also save drafts automatically.
Print pick listOpens 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 shipmentTakes the stock off the warehouse — all of it or none. Optional Carrier, Tracking number and Packages go on the report.
Cancel withdrawalKeeps 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.

A shipment cannot be undone here

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

Section 55 · Withdraw for Delivery · 6 min
Goal: Record the delivery confirmation, any discrepancy and the paperwork, then close the withdrawal.

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

  1. When the department confirms it arrived, open the withdrawal.
  2. 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.
  3. 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

Table: Stage, You can still change
StageYou can still change
DraftEverything: details, items, quantities, lots. Or cancel it.
ShippedCarrier, 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.
DeliveredThe delivery confirmation, the discrepancy and its resolution, and documents.
Closed or CancelledNothing. 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

Section 56 · Receiving and returns · 7 min
Goal: See what is on its way, find a delivery by scanning its paperwork, and open the right request to receive it.

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.

Expected Inbound Deliveries with pending receipts, items inbound and overdue tiles, filters and a table of purchases and transfers awaiting receipt
Inbound Deliveries. Everything approved and on its way, with source, destination, tracking and what is still outstanding.
Admin & manager note

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.
Scan the packing slip

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

Table: Column, Shows
ColumnShows
Request #A link to the request, with a purchase or transfer icon.
TypePurchase or Transfer.
Need ByThe date and 3d overdue, Today or in 5d.
Source, DestinationSupplier or sending site; where it is going.
Tracking #The first number and +N more.
External POYour workspace's label for the finance system's PO number.
Items, Outstanding QtyLines and units still to come.
StatusOverdue, 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:

  1. Type in Search by number. Only open requests are offered (not completed, canceled or rejected), shown as number · type · stage, up to 20.
  2. 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.
  3. 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

Section 57 · Receiving and returns · 7 min
Goal: Understand what happens to stock received without a purchase order, and close each exception by adding the purchase order number.

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.

External PO is your workspace's word

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:

Table: Setting, Stock without an External PO, To close the exception
SettingStock without an External POTo close the exception
OffHeld: on the shelf but reserved and unavailable.Add the External PO; every line of the delivery is released.
OnOn 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.
Table: Column, Shows
ColumnShows
ReceiptIts reference, how many lines, stock held or stock on hand, and For a department.
ReceivedDate and time.
Supplier / deliveryWho sent it and the delivery reference.
Items, Location
External POAn amber External PO required chip, or the number.
StatusPending (with N of M lines still open) or Resolved with when and by whom.
PaperworkAttached files, and Attach for editors — the invoice often arrives after the boxes.

Closing an exception

  1. 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.
  2. In Resolve exceptional receipt, check the Pending delivery and its facts.
  3. 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.
  4. Select Release & close (or Close when the stock is already on hand). Tansi says Released and closed ... (N line(s)).
Admin & manager note

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

Section 58 · Receiving and returns · 9 min
Goal: Record a delivery that has no Tansi order behind it, line by line, with its paperwork — or save it as a draft until the paperwork arrives.

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

Table: Field, Notes
FieldNotes
Receiving locationRequired. Each item then picks its own spot inside it, so one delivery can split across a fridge, a shelf and a cage.
Supplier or sourceRequired. Who sent it.
Packing slip / delivery referenceRequired. 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 categoryRequired: Purchase card / direct purchase, Emergency purchase, Donation / sample / no-charge delivery, Authorized non-PO replenishment or Other approved exception.
DepartmentWho the delivery is for. Filled in from the items when they all belong to one.
Business justification / exception contextRequired, 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.

Table: Line field, Notes
Line fieldNotes
Item
QuantityQuantity, or for container items Vials received (the container word) with the Stock quantity in doses worked out for you.
Unit costFeeds the Estimated value.
Put away intoWhere 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 detailsLot number and expiry date (required when the item requires them), serial number, manufactured date, manufacturer, and the item's own tracking fields.
Funding sourceOptional.

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

  1. Read the summary of what will happen to the stock.
  2. Tick I confirm this delivery may be recorded under the approved exceptional receiving procedure.
  3. 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.

Changing the receiving location

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

Section 59 · Receiving and returns · 7 min
Goal: Decide what happens to stock that stations sent back: restock it, dispose of it, or return it to the vendor.

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.).

Table: Button, What happens, You enter
ButtonWhat happensYou enter
RestockIt becomes usable stock at that place again: it can be picked, sent and withdrawn.Quantity, optional Note.
DisposeIt comes off stock and is recorded on the waste report.Waste reason (required), Quantity, optional Note.
Return to vendorStarts 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.

Admin & manager note

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

Section 60 · Waste · 8 min
Goal: Record waste for one item or many, and review every disposal with its reason, place and person.

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.

Waste Management with date, product, location and reason filters, totals, and the disposal audit table
Waste Management. All waste across locations, from people and from the expiry clock, with who recorded it.

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.

Admin & manager note

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.:

  1. Under Where and who, choose the Location. On a shared account, fill in Recorded for (required there, optional otherwise).
  2. Under Applies to every line, choose a Waste reason and add Notes (optional) (up to 500 characters, for example fridge failure overnight 12 Sep).
  3. 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.
  4. 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).
  5. 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.

A batch is not all-or-nothing

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 ....

Expired after opening appears here

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

Table: Filter, Notes
FilterNotes
From, ToDefault: the first of this month to today.
ProductOne product, or all.
LocationOnly places you can see; empty means all of them (All my locations).
Apply filtersReloads with the dates, product and location.
Search resultsItem, SKU, lot, reference or person, within what is loaded.
Waste reasonOne of the reasons present.
ResetBack 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

Section 61 · Keeping stock topped up · 8 min
Goal: Find every item that is short at any location, and judge how urgent each one is.

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.

Tansi Reorder Suggestions showing items below reorder and below minimum, a suggested order value, and a table of items with on hand, suggested quantity and days left
Reorder Suggestions. Everything at or below its reorder threshold, with a suggested quantity and how many days of stock are left. Tick items and turn them straight into a purchase draft.

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.
Exactly at the reorder point is not listed

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

Table: Column, What it tells you
ColumnWhat it tells you
Item NameWith SKU and category.
LocationWith the path above it, so a storage room says which site it is in.
On Hand, AvailableAvailable is red below the minimum, amber below reorder, with Reorder | Min | Max underneath.
Reorder, Min, MaxThe levels used.
Suggested QtyWith 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 LeftHow long stock lasts at recent use: red under 7, amber under 14, N/A without usage.
Avg/DayAverage 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.

Days left beats items below reorder

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

Section 62 · Keeping stock topped up · 9 min
Goal: Turn selected suggestions into supply requests or purchase drafts — one per supplier — and save a snapshot of the list.

Tick the rows you want. The header buttons count your selection.

Table: Button, What it creates, Who sees it
ButtonWhat it createsWho 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 SnapshotKeeps a record of the list as it stands: Snapshot saved — N recommendations captured.Everyone on the page
RefreshReads 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

  1. Select Create Purchase Draft (or the cart icon on one row).
  2. 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.
  3. Choose Add selected (N), Continue (without extras) or Cancel.
  4. 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

  1. Select Create Purchase Draft.
  2. 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.
  3. 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.
  4. Select Create N drafts. Tansi says how many it created and opens your Requests list.
  5. 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.

Unpriced drafts route as zero-value orders

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.

Not only for clinics

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

Section 63 · Keeping stock topped up · 3 min
Goal: Look back at what Reorder Suggestions recommended on a given day.

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.

Table: Column, Shows
ColumnShows
DateWhen it was taken. Select it, or the row, to open it.
SourceAutomated (nightly) or Manual.
Items EvaluatedHow many item and location rows were checked.
RecommendationsHow many were short.
FiltersFiltered 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.

Why keep snapshots

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

  1. Open Snapshot History and find the nightly snapshot from the week before the stock-out (Automated).
  2. Open it and look for the item at that location. If it is there, the system did suggest it: check whether an order followed.
  3. 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.
  4. Export the snapshot lines if you need to share them.

Order Schedule

Section 64 · Keeping stock topped up · 5 min
Goal: See which facilities are due to order and start an order from their template.

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.

Order Schedule with Due list and Calendar tabs and an empty due list
Order Schedule. Facilities with an ordering schedule appear here with their next due date.

Due list

Table: Column, Shows
ColumnShows
FacilityA link to Location Management.
Next dueThe date, with Due (red) when it is due or overdue, or Due soon (amber) inside the lead window before it.
DaysDays until it is due.
CadenceHow often: the frequency and the interval, shown as frequency × interval.
TemplateThe request template the order starts from.
On handN 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.

Schedules are set per facility

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

  1. An administrator gives the remote site a weekly schedule with a two-day lead window and the template Weekly site order.
  2. Two days before each due day the site shows Due soon; on the day it shows Due.
  3. The site coordinator selects Start order. A draft opens with the template's items, dated for the due day.
  4. She checks quantities against what is on hand, adjusts them, and submits. If she misses the day, the calendar keeps showing it as overdue.
Calendar and stock levels together

Use the schedule for the routine order and Reorder Suggestions for anything that runs short between orders.

Use cases: day-to-day stock control

Section 65 · Use cases: stock work · 10 min
Goal: Follow complete examples of moving, counting, correcting and writing off stock in different kinds of workplaces.

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)

  1. A yard hand opens Move Stock from the menu and picks the yard as From location.
  2. She scans a box of anchor bolts and a roll of tape; each scan adds a line.
  3. For each line, Coming from is already chosen (they sit on one rack) and under Going to she picks Van 3.
  4. 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)

  1. The office manager opens Inventory Count and picks the cupboard in Count locations. Its rows load.
  2. She types what she finds in Counted. Printer paper: expected 20, counted 18. Pens: expected 5 boxes, counted 7.
  3. She sets paper to Unrecorded issue / usage and pens to Found.
  4. Toner was not checked, so she leaves it blank — it will not be touched.
  5. 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)

  1. Rain gets into a tent store and ruins four kinds of signage and two boxes of programs.
  2. The store lead opens Waste Management › Record waste, picks the tent store, sets Waste reason to Damaged and notes storm, 14 Jun.
  3. She scans each item; lines fill in. One sign is held in two lots, so she picks the lot on that line.
  4. 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)

  1. A picker reports the system shows 50 hard hats but the shelf has 48, and nobody can find any loss.
  2. 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.
  3. Apply Adjustment. Had the two been broken, waste would have been the right record.

5 · Finding the right lot during a count (clinic)

  1. During a count a nurse finds a lot of dressings with water damage.
  2. From the line's menu she selects Mark quarantined and gives the reason.
  3. 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.
  4. 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)

  1. A manager sees an item out of stock on Critical Items.
  2. 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.
  3. 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

Section 66 · Use cases: stock work · 10 min
Goal: Follow complete examples of exceptional receipts, delivery withdrawals, returns and reordering.

1 · A purchase-card buy arrives before the paperwork (office)

  1. Toner bought on a purchase card arrives. The receptionist opens Stock Levels › Exceptional receipts › Add receipt.
  2. 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.
  3. 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.
  4. 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)

  1. The Housing department emails asking for 30 smoke alarms and 10 fire blankets.
  2. Warehouse staff open Withdraw for Delivery › New withdrawal, pick the warehouse, type the request details and choose A department: Housing.
  3. 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.
  4. Save draft, then Print pick list. The picker works from the printout.
  5. When the van leaves they add the carrier and tracking number and select Record shipment. The stock comes off the warehouse.
  6. 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.

  1. 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.
  2. Six boxes are sealed: Restock, quantity 6.
  3. Two are torn: Dispose, quantity 2, reason Damaged.
  4. 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)

  1. On Monday the buyer opens Reorder Suggestions, sets Usage window to 30 days and sorts by Days Left.
  2. She ticks everything under 14 days — 18 rows from four suppliers.
  3. Save Snapshot, so there is a record of what was suggested.
  4. 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.
  5. 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)

  1. Order Schedule shows a remote facility Due soon for Thursday.
  2. The coordinator selects Start order; a draft opens from the facility's template, dated Thursday.
  3. She adjusts quantities against Reorder Suggestions for that location and submits.

Scan & Receive: looking items up

Section 67 · Scan & Receive · 8 min
Goal: Scan or type a barcode, read what Tansi knows about the item, and act on it in one place.

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.

Scan and Receive with the barcode field, the handheld scanner switch, recent scans and the Receive without a requisition order button
Scan & Receive. Scan or type a barcode. The button label follows the workspace's own name for purchase orders.

Scanning

Table: Way, How it works
WayHow it works
TypingType in Scan or enter a barcode and press Enter or the search icon.
Handheld scanner switchTurn 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 cameraScans 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

Table: Button, What it does, Needs
ButtonWhat it doesNeeds
Receive stockOpens a receipt without a purchase order, with this item filled in.Receiving permission
Adjust stockOpens the Adjust Stock dialog.Edit on stock tracking
TransferStarts a stock transfer request for this item.Permission to create transfers
Create Purchase OrderStarts a purchase order for this item (your workspace's name for it).Permission to create purchases
View itemOpens the item page.—
Edit itemOpens the item's edit page.Edit on Item Master
Print labelPrints 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: …).

Two buttons that do less than you might expect

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.

Screen recording: adding inventory the first way, through the item and lot screens
Watch it done (3 minutes). The first way to add inventory, start to finish. The walkthrough recording is in the Module 06 manual.

Option 2 — the quicker route, when the item already exists and you only need the stock booked in.

Screen recording: adding inventory the second, quicker way
Watch it done (1 minute). The quicker route to the same result. The walkthrough recording is in the Module 06 manual.

Scan & Receive: unknown barcodes and request codes

Section 68 · Scan & Receive · 6 min
Goal: Add a new product from its barcode, and use a request's barcode or QR code to see and act on the request.

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:

Table: Button, What it does, Needs
ButtonWhat it doesNeeds
Look up product dataSearches Go-UPC, an outside product database (Looking up product data in Go-UPC…).Edit on Item Master
Create item manuallyOpens a blank new item, and brings you back here afterward.Edit on Item Master
Re-scanPuts 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.

Go-UPC lookups are counted

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.
Table: Button in the drawer, Shown when
Button in the drawerShown when
ReceiveYou may receive this kind of request, a line is still outstanding, and something has been sent or shipped.
Warehouse work orderIt is an approved or active transfer and you work the warehouse queue.
Open requestAlways.

Use cases

  1. 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.
  2. 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.
  3. 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

Section 69 · Carriers · 8 min
Goal: Keep your list of shipping carriers, with accounts, services and insurance, so shipping screens offer the right ones.

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.

Table: Column, What it shows
ColumnWhat it shows
NameWith a star for preferred carriers, and the city.
Code, TypeShort name and carrier type.
ContactMain contact and phone.
Account #Your account number with the carrier.
ServicesThe first three service levels, then +N more.
StatusActive, Suspended, Pending Approval, Expired Insurance, Blacklisted or Inactive (your workspace's status list).
ActionsView / 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.

Table: Tab, Fields
TabFields
Basic InfoCarrier 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 & BillingCarrier 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.
ShippingService 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.
TrackingTracking URL (use {tracking_number} where the number goes); switches API Enabled, Label Printing, Rate Quote Supported, Shipment Status Sync.
OperationsPreferred 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.

Set the tracking URL once

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)

  1. A contractor ships tools between its yard and job sites with a regional courier. Open Carriers and press Add Carrier.
  2. Enter the name, code RCX, type and the dispatch email.
  3. On Account & Billing, enter the account number, payment terms Net 30 and the Freight account.
  4. On Shipping, list Same day, Next day as service levels and switch on Liftgate Available.
  5. On Operations, switch on Preferred Carrier ⭐ and Use for Internal Transfers, enter the insurance expiry, and press Create.
  6. Thirty days before the insurance runs out, the carrier is counted on the Insurance Expiring tile.

The Lots board

Section 70 · Lots, expiry and recalls · 9 min
Goal: Use the Lots board to spot expiring, expired, quarantined and recalled stock, and find exactly where it sits.

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.

Lot and Inventory Tracking with tiles for total lots, expiring soon, expired, quarantined and recalled, filter chips and the lot table
Lots. Expired and flagged lots sort to the top, with where each one sits.

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.

Table: Tile, What it counts, What to do
TileWhat it countsWhat to do
Total lotsEvery lot passing your search and switches, with N need attention.—
Expiring soonActive 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.
ExpiredLots past their expiry date.Do not use them. Record them as waste, or return them if they carry a Credit return chip.
QuarantinedLots on hold: on hold, do not ship.Leave them where they are until the hold is decided.
RecalledLots 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

Table: Column, What it shows
ColumnWhat it shows
Lot #The lot number.
ItemThe item, its manufacturer, and a Credit return chip when the supplier takes it back.
CategoryHidden on narrower screens.
ExpiryThe date and how far away it is: in 12 d, today or 5 d ago.
On handEverything held, across the locations you can see.
AvailableOn hand minus reserved.
Where it sitsA chip per location with its quantity. After six chips, +N more expands the rest.
StatusAvailable, Expiring soon, Expired, Quarantined, Suspended or Recalled.
CreatedWhen 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.

Held stock still counts as on hand and available here

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.

FEFO

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

Section 71 · Lots, expiry and recalls · 7 min
Goal: Open a lot, see where every unit of it is and where it has been, and put it on hold or bring it back.

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:

Table: Lot is, Buttons, Use it when
Lot isButtonsUse it when
ActiveQuarantineSomething needs checking: a temperature excursion, damaged packaging, a supplier query.
SuspendThe lot should be taken out of use for a while, for a reason that is not a recall.
RecallThe maker or supplier has issued a recall notice.
Quarantined, Suspended or RecalledReactivateThe check is over and the lot can be used again.
  1. Press the button. A dialog titled, for example, Quarantine lot shows Lot A2251 → Quarantined.
  2. Type the Reason. It is required and is shown to people who later meet the lot.
  3. 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.
Admin & manager note

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.

Table: Field, Notes
FieldNotes
Lot numberRequired. Must stay unique for the item.
Expiry dateNeeds 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, ManufacturerOptional.
Serial number, tracking fieldsShown when the item asks for them or the lot already has a value.
NotesUp 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

Section 72 · Lots, expiry and recalls · 7 min
Goal: Give lot numbers to stock loaded without them, settle a scanned expiry that disagrees with the lot on file, and pick lots by hand.

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.

  1. 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.
  2. Press Assign on a row. The drawer shows Still untracked and Lotted this session.
  3. 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).
  4. Enter the Expiry date (required when the item needs one). Picking an existing lot fills in its expiry and locks it.
  5. Enter the Quantity in this lot, or press All remaining, and an optional note.
  6. 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.

Table: Part, What it does
PartWhat it does
LotThe lot number; Unspecified marks stock without one.
ExpiryRed when past, orange within 30 days.
On handWhat that lot has available here.
Qty to useHow much to take. Typing more than the lot holds is cut back, with Only N on hand.
Reset to FEFOFills the quantities soonest-expiry first (stock without a lot comes first).
TotalShows 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

Section 73 · Lots, expiry and recalls · 7 min
Goal: Handle a recall, a monthly expiry review and a lot correction from start to finish.

1 · A supplier recalls a lot (health)

Not only for health care

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.

  1. The supplier emails a recall for lot K4410 of an IV set. Open Stock › Lots and search K4410.
  2. Click the row. Under Locations holding this lot you see 30 units at the depot and 6 at two clinics.
  3. Press Recall, type the supplier's notice number as the reason and press Apply.
  4. Export the locations table and send it to the clinics. Anyone who scans the lot now sees a Lot status warning.
  5. Raise returns from the clinics to the depot; the return picks offer the recalled lot.
  6. Export Transaction history as evidence of where the lot went before the recall.

2 · Monthly expiry review (warehouse)

  1. On the first of the month, open the Lots board and click Expiring soon.
  2. Set Expiring within to 3 Months. The cut-off date appears beside it.
  3. Sort by Expiry. For lots expiring soonest, look at Where it sits and move them to the busiest site.
  4. Click Expired. Record expired lots as waste, or return those with a Credit return chip to the supplier.
  5. 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)

  1. The adhesive maker warns that batch 22-118 may cure badly. Open the lot and press Quarantine with the warning as the reason.
  2. The lot disappears from FEFO suggestions, so crews requesting adhesive are sent other batches.
  3. 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)

  1. An office receives toner and types lot TN-0O4 instead of TN-004.
  2. Find it on the Lots board and press the pencil.
  3. Correct Lot number, type Typo at receiving in Why are you changing it? and press Save changes.

5 · Opening stock without lots (events)

  1. An events company loaded 4,000 wristbands with a spreadsheet, without lot numbers, but wristbands are lot-tracked by color batch.
  2. On the Lots board, press Assign lots to untracked stock and pick the warehouse row.
  3. Assign 2,500 to lot BLUE-26 and press All remaining for lot GOLD-26.

The Item Master list

Section 74 · Item Master · 7 min
Goal: Read the Item Master page, switch between cards and the table, and know what every chip, column and button means.

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.

Item Master in card view with counters for total, active, inventory and assets items, the search bar, filters and item cards
Item Master. The counters double as filters. Cards show the picture, SKU, type and category chips.

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

Table: What you see, What it tells you
What you seeWhat it tells you
Find missing picturesLooks up product photos by barcode for items that have none. See Pictures, documents and safety data.
Add ItemOpens a blank item form.
Total ItemsHow many items the list has loaded with the current status filter.
ActiveHow many of those are active.
Inventory / AssetsThe split between stock you use up and things you keep and maintain.
The tiles count what is loaded, not the whole catalog

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

Table: Column, Shows
ColumnShows
(photo)A thumbnail. Click it to see the picture larger.
NameThe name, flag chips, Needs review, a Child of link and the start of the description.
SKUYour code, the primary barcode as BC: …, and the lots link.
CategoryThe category path, and Department: … when one is set.
ClassificationInventory or Asset.
UnitThe unit of measure, with (N/pkg) when one unit holds more than one.
StorageThe storage type, such as Refrigerated.
LocationThe item's default location.
Preferred SupplierThe supplier marked preferred on the item.
ReorderThe reorder threshold.
StatusActive or Inactive; hover for the deactivation reason.
ActionsView 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

Table: Chip, Meaning
ChipMeaning
CriticalThe item must never run out. It feeds the Critical Items page.
Controlled / RestrictedThe item takes the controlled approval route. Cards call it Controlled; the table, quick view and item page call it Restricted. Same flag.
HazardousShown on cards for hazardous items.
RefrigeratedThe storage type is named Refrigerated (table and item page).
ParentA generic item that is never stocked itself; its child items are.
Non-stockedBought to order from a vendor when someone requests it.
Credit returnThe vendor takes it back for credit, so send it back instead of throwing it away.
Needs reviewCreated from a barcode lookup or import and not yet checked by a person.
Refrigerated needs the exact name

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.

Admin & manager note

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

Section 75 · Item Master · 5 min
Goal: Find any item quickly by name, code or barcode scan, and narrow the list with the filters.

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

  1. 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.
  2. 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.
  3. If not, Tansi searches names, SKUs, barcodes and lot numbers as text.
  4. 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.
Scanning is the fastest way to an item

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

Table: Filter, Choices, Notes
FilterChoicesNotes
ClassificationAll · Inventory · AssetsInventory is stock you use up; assets are things you keep.
StatusAll statuses · Active · InactiveStarts on Active.
FamilyAll families · Parent items only · Child items only · Not in a familyFor generic items and the products under them.
DepartmentAll departments · each department · No departmentAppears only when at least one loaded item has a department.
CategoryA searchable list of categoriesShows only categories your items use, indented under their parents, each with an item count. Picking a category includes everything filed beneath it.
Needs reviewOn / offShows 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.

Inactive items are hidden until you ask for them

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

Section 76 · Item Master · 7 min
Goal: Use the quick view for a fast look, open the full item page, and use its action strip and side panel.

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.

The item quick view panel showing basic information, thresholds per location, on-hand totals, safety, alternatives, attachments and suppliers
Quick view. Click a card to see the essentials without leaving the list. See details page opens the full item page.
An item page with picture, name, SKU, barcode, unit and status, the detail strip, tab bar and the available stock panel
The item page. Actions run along the top, the tabs hold the detail, and the right panel shows stock by location.
Table: Part, Shows
PartShows
HeaderPhoto, name, SKU, unit and category, Active/Inactive, Child of …, Needs review and flag chips.
See details page / EditShown only to people allowed to open or edit the item.
Basic informationDescription, brand, barcode, classification, storage, default location, units per package, the thresholds that apply where the stock is, and on hand with the busiest locations.
SafetyLinked safety data sheets with supplier, signal word and status.
AlternativesItems that can stand in for this one.
Child itemsGeneric items only: the products under it, in preference order, with on hand.
AttachmentsFile names; Open the details page to download or add files.
SuppliersSupplier, 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:

Table: Button, What it does, Who sees it
ButtonWhat it doesWho sees it
Deactivate / ActivateRetires the item with a reason, or brings it back.Editors
DeleteRemoves an item that was never really used.Editors
EditOpens the item form.Everyone in the strip; editors also get an Edit button in the header
CopyCreates Copy of … and opens it for editing.Editors
Print labelsPrints a label for the primary barcode.Everyone
Show barcodesJumps to the Barcodes tab.Everyone
Asset relationshipsOpens the matching asset in Maintenance.When the item is an asset with a Maintenance record
… menuOpen 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

Table: Card, Shows
CardShows
Available StockWhat 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 supplierSupplier, price, lead time and supplier SKU. Only for people allowed to see costs.
Reorder ThresholdsMin, reorder and max, and one sentence such as On hand 40 — at or below the reorder point of 50.
Why the badge and the big number can disagree

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.

Admin & manager note

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

Section 77 · Item Master · 8 min
Goal: Read where an item's stock is, how it is set up to be counted and ordered, what has happened to it, and work its open 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.

The Containers tab of an item with the Tracked packages panel and the Include used or wasted switch
Containers tab. Tracked packages appear once stock is received with a package count. Turn on Include used / wasted to see finished ones.

Locations

On-hand by location lists every place the item sits:

Table: Column, Meaning
ColumnMeaning
LocationWhere it is. Generic items add a Child item column.
Storage areaThe cabinet, drawer or shelf inside the location, or Unassigned.
On handEverything physically there.
Quarantined / Suspended / RecalledOn hand but held in a lot that must not be used.
ReservedPromised to an open request.
AvailableWhat 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.

Table: Status, Meaning
StatusMeaning
SealedNot opened yet.
OpenIn use. Open expires counts down, for example 5h 20m, then reads Overdue.
UsedIts remaining count reached zero.
WastedThe rest was thrown away and recorded as waste.
ExpiredRan 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.

Dispensing is not only for medicine

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

Section 78 · Item Master · 7 min
Goal: Find an item's description, custom fields, alternatives, family, files, safety sheets, barcodes, scan settings and suppliers on its page.
Table: Tab, What it holds
TabWhat it holds
OverviewA 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.
AlternativesSubstitute items in priority order with notes and status. Editors get Manage Alternatives.
Child itemsFor a generic item, its products. For a child, which parent it belongs to. Otherwise a note that it is not in a family.
AttachmentsRecords and documents. Editors can add and remove them here.
SafetyThe safe handling procedure and the linked safety data sheets.
HistoryMovements in and out (see the previous section).
FormsForms assigned to this item or asset.
BarcodesEvery registered barcode, with image, print, and (editors) add, generate, edit and delete.
Smart ScanWhether QR, NFC and RFID tags are allowed for the item.
SuppliersWho 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.

Done is not saved

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.

Admin & manager note

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

Section 79 · Item Master · 9 min
Goal: Create a new item, fill in its core information and category fields, and save it.

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

Table: Field, Notes
FieldNotes
Item NameRequired, up to 200 characters. Must be unique in the workspace.
DescriptionUp to 500 characters.
SKU / Internal IDYour own code, up to 100 characters. Must be unique in the workspace.
BarcodeRead-only: Synced from primary barcode. Manage barcodes on the Barcodes tab.
Brand / ManufacturerUp to 200 characters.
CategoryA top-level category. Changing it clears the subcategory and reloads the category fields.
SubcategoryAny 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 typeGoods or Services. Used by supply approval routing.
ClassificationInventory (stock that gets used up) or Asset (things you track and maintain).
This is a generic itemInventory only. Turn on to group products from different suppliers under one name. See Generic items, child items and alternatives.
ProjectOptional. 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.

Answers to hidden fields are not kept

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

  1. Press Create Item, at the top or in the bar at the bottom. It stays gray until the item has a name.
  2. 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.
  3. 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.

Pictures come after the first save

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

Section 80 · Item Master · 6 min
Goal: Set an item's default location and owner, place its stock in storage areas, and decide which locations see it in their catalog.

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.

Admin & manager note

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:

Table: Choice, Effect
ChoiceEffect
Everyone its owner shares it withThe default.
Only some kinds of locationPick 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 teamNobody else can see or order it.
Pick at least one kind

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

Section 81 · Item Master · 9 min
Goal: Set an item's unit, whether it holds several units or uses, how it is stored, and the levels that drive reordering.

The Packaging & Stock tab decides what your stock is counted in and when Tansi suggests ordering more. Its first card is Packaging, Storage & Stock.

The Packaging and Stock tab showing unit of measure, contains multiples, uses per unit, stock levels, preferred vendor and per-location overrides
Packaging & Stock. Here Contains multiples is No and uses per unit is 12, so stock is counted in boxes and each box gives 12 uses. Per-location rows override the main levels.

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.

Table: , Contains multiple units — ON, OFF
Contains multiple units — ONOFF
FieldsContainer name (up to 50 characters, such as vial, box, package), Units / uses per container, Expires after opening (hours), Generate a barcode for each received containerUses / doses per unit
Stock is counted inThe units inside: a box of 12 counts as 12Whole units: a bottle of 100 counts as 1
Expiry after openingYes, the hours you enterNo
Typical forA vial of 10 doses, a box of 12 hard hats issued one by one, a drum of cleaner poured out by the literA 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.

Need an expiry after opening? Use container mode

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.

Not only for medicine

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:

Table: Field, Meaning
FieldMeaning
Min StockBelow this is urgent.
Max StockThe most you want to hold at one time.
Reorder ThresholdAt or below this on hand, the item starts appearing in Reorder Suggestions.
Minimum order quantityAn order must be for at least this many, and new order lines start here (blank = none).
Order multipleOrder 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.

Get the reorder threshold right

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

Section 82 · Item Master · 7 min
Goal: Decide what must be recorded when an item is received, and set the controlled, critical, credit-return and stocked flags.

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.

Table: Switch, Effect at receiving
SwitchEffect at receiving
Require lot number when receivingA lot number must be entered. Recalls and quarantine then work by lot.
Require expiry date when receivingAn expiry date must be entered for each lot received.
Require serial number when receivingA serial number must be entered for each one.
Three custom rowsSwitch 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.

Existing stock does not need back-filling

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

Table: Switch, What it does
SwitchWhat it does
Controlled (restricted) — takes the controlled approval routeOrders 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 KPIMarks a must-never-run-out item. It gets a red Critical chip and appears on Critical Items.
The vendor takes this back for creditShows 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.

Controlled can come from the category

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.

Not only for clinics

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

Section 83 · Item Master · 8 min
Goal: Set an item's standard cost, product fees and taxes, and link the suppliers who sell it with their prices and lead times.

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

Table: Field, Notes
FieldNotes
Item costDefault cost per unit, before extras and taxes.
Product feesUp 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.
TaxesUp 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.

Fees are always added

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:

Table: Field, Notes
FieldNotes
SupplierActive vendors not already linked to this item.
Supplier SKUThe vendor's own code for the product.
PriceWhat this vendor charges per unit.
Lead daysHow long their deliveries take.
Account codeOnly when your workspace has imported finance codes: the account purchases are coded to.
Charges the item's taxesTicked by default. Untick for a vendor who does not charge the item's taxes.
PreferredThe 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.

Admin & manager note

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

Section 84 · Item Master · 7 min
Goal: Register, generate, edit and print an item's barcodes, choose whether a scan counts as one unit or a whole package, and set its smart-tag options.

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

  1. Press Add Barcode.
  2. Scan or type the Barcode Value (required, up to 500 characters), or press Generate for a new unique value starting BC-.
  3. 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.
  4. Press Preview to see the bars.
  5. Add a Label / Description if useful, such as Vendor barcode or Warehouse A label.
  6. Set Scan counts as: Single unit, or Package / case for a code on the outer box.
  7. Tick Primary Barcode for the code shown on the item and printed on labels. Only one barcode can be primary.
  8. 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.

Editing a barcode resets Scan counts as

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.

Delete on the edit form has no confirmation

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

Section 85 · Item Master · 8 min
Goal: Add and arrange item pictures, find missing pictures by barcode, attach documents, link safety data sheets and write a safe handling procedure.

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.

  1. 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.
  2. Press Search N items. A progress bar counts Looking up x of y…; Stop halts it.
  3. Review the matches: each row shows the picture, Our item and Found as. Untick any that show the wrong product.
  4. 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:

Table: Tab, How it works
TabHow it works
Upload PDFDrop 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 ExistingSearch 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.

Several things on this tab save on their own

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

Section 86 · Item Master · 8 min
Goal: Group interchangeable products under one generic item, set their preference order, and list substitutes for when an item runs out.

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

  1. 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.
  2. 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.
  3. 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.
  4. Drag rows, or type a number in Order, to set the preference order.
  5. Set the min, max and reorder levels on Packaging & Stock, in the unit you count in.
  6. 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.

A parent with no children cannot be supplied

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.

  1. Open a saved item's form and go to Alternatives.
  2. Type in Search items and press Search. Optionally type Notes for the added items, such as Only for indoor use.
  3. Tick the items (Select all visible ticks every one) and press Add selected.
  4. Drag rows or type an Order number to rank them. Edit a note in place; it saves when you leave the box.
  5. 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.

Cancel does not undo

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.

Not only for health care

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

Section 87 · Item Master · 5 min
Goal: Deactivate an item that is no longer used, delete one created by mistake, bring one back, and copy an item as a starting point.

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.

  1. Press Deactivate on the item page's action strip, or the block icon in the Item Master table.
  2. Type a Reason (required, up to 500 characters), for example discontinued by the manufacturer, replaced by the 20 L drum or recalled lot.
  3. 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.

Delete cannot be undone

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.

Table: Copied, Not copied
CopiedNot 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, projectSKU, 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
Check the flags on a copy

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

Section 88 · Item Master · 10 min
Goal: Follow complete, realistic walk-throughs of the most common Item Master jobs from start to finish.

1 · A new consumable from a barcode (office supplies)

  1. An office manager opens Item Master, presses Add Item, scans a box of pens into Look up by UPC / EAN and presses Look up.
  2. Name, brand and a photo fill in. She picks Category Office › Writing and sets Department to Front desk.
  3. On Packaging & Stock she sets the unit to Box, Reorder Threshold 4, Max Stock 12.
  4. 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)

  1. A janitorial lead creates Floor stripper, 20 L drum and on Packaging & Stock turns on Contains multiple units.
  2. 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.
  3. Under Receiving requirements he turns on lot number and expiry date; on Safety he ticks Requires SDS and attaches the sheet.
  4. When drums arrive each gets its own barcode; the Containers tab shows each drum Sealed until someone opens one.
Dispensing is not only for medicine

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)

  1. 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.
  2. 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.
  3. 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)

  1. A pharmacy lead opens an item filed in a category marked Controlled substances: the Controlled switch is already on and locked.
  2. She types a Restriction reason, turns on Critical, sets Shown to Only some kinds of location and ticks Health Center, then saves.
Not only for clinics

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)

  1. 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.
  2. She presses Deactivate, types Replaced by the 2026 line array, and confirms.
  3. 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)

  1. A warehouse lead turns on Needs review in the Item Master to see items created from barcode lookups.
  2. 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.
  3. He finishes with Find missing pictures to fill in photos for anything still without one.

Categories and child categories

Section 89 · Catalog setup · 8 min
Goal: Build the category tree items are filed under, add child categories at any depth, and set a category's finance account and controlled status.

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.

Inventory Categories as a hierarchy with root and child categories, parent, comment, company, hidden and tenant columns
Categories. Root categories and the child categories beneath them, in one table.

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.

Table: Column, Shows
ColumnShows
IconThe category's icon.
CategoryThe name with its level.
ParentThe path above it, or Root.
CommentYour note on what belongs here.
CompanyThe company the category belongs to.
Is Hidden?Whether it is hidden from pickers.
ActionsAdd 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

Table: Button, What it does
ButtonWhat it does
Add Root CategoryOpens 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

Table: Field, Notes
FieldNotes
DescriptionThe category name. Required.
IconSelect Icon / Change Icon opens an icon picker.
CommentWhat belongs here.
CompanyRequired. Cannot be changed once fields are added.
ProjectOptional; available after a company is chosen.
Category ID, Cost Code, Other IDYour own codes, up to 25 characters each.
Parent CategoryChild categories only. Locked once the child has fields of its own, and cannot be changed when editing.
Finance accountEdit page. Purchases of items in this category are coded to it. Blank uses the parent category's.
Controlled substancesEdit 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.

Not only for drugs

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.

Hidden can only be set when adding a child

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.

Admin & manager note

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

Section 90 · Catalog setup · 8 min
Goal: Add custom fields to a category so every item filed under it records the details you need, with types, limits and branching rules.

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

  1. Open the category's create or edit page and choose the Company first; fields cannot be added without one.
  2. Press Add Field.
  3. Type the Field name, for example Brand, Color or Country of origin.
  4. Choose the Type (see below) and fill in what that type asks for.
  5. Tick Required, Hidden or Show in summary as needed.
  6. Optionally switch on Conditional logic (branching).
  7. Reorder fields by dragging the handle or with the arrows, then save the category.

Field types

Table: Type, Use it for, Extra settings
TypeUse it forExtra settings
TextFree-form text: descriptions, names, codes.—
NumberNumeric values only.Min value, Max value
DateA calendar date.Min date, Max date
CheckboxA list where one or more can be picked on each item.Type the options; at least one.
Radio buttonsA list where only one can be picked.Type the options; at least two.
Custom Dropdown CategoryA 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.

Options are fixed after saving

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

Table: Tick, Effect
TickEffect
RequiredThe field must be filled in.
HiddenKept off the item page's display.
Show in summaryShown 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.
A new child category is limited to 20 fields

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

Section 91 · Catalog setup · 5 min
Goal: Create and maintain the named lists of values that category fields can offer as pick 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.

Lists, not fields

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

  1. Press Create Custom Dropdown Category.
  2. Type the Name and choose the Company (both required).
  3. Press Create. Tansi says New Custom Dropdown Category added successfully! and returns to the list.
  4. 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.).

Admin & manager note

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

Section 92 · Catalog setup · 7 min
Goal: Maintain your workspace's departments, units of measure and storage types, manage funding sources, and read the inventory 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.

Table: List, Used for
ListUsed for
DepartmentsWho 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 measureWhat items are counted in. Add your own beside the shared ones.
Storage typesHow 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.

Switch off rather than delete

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.

Table: Column, Shows
ColumnShows
NameThe funding source.
CodeA short code for tight report columns, such as P.
ScopeThis tenant, or Global for ones Tansi provides.
StatusActive or Inactive.
  1. Press New Funding Source.
  2. Type the Name (required) and a Code of up to 20 characters. Leave Active on.
  3. 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.

Admin & manager note

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

Section 93 · Catalog setup · 8 min
Goal: Bring items, suppliers, locations, opening stock, barcodes and more into Tansi from a spreadsheet, check them first, and read the import history.

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

Table: Mode, Effect
ModeEffect
Insert OnlyAdds new rows; leaves existing records alone.
Update OnlyChanges existing records; adds nothing new.
Upsert (Insert + Update)Adds what is new and updates what exists. The default.

Running an import

  1. Choose the Import Type and Import Mode.
  2. Press Download Template and fill it in. The Templates tab has every template; required columns are highlighted in blue.
  3. Press Select File (.xlsx or .csv) and pick your file.
  4. Press Validate & Preview. Nothing is saved yet. Keep the page open; a large file can take a minute.
  5. 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).
  6. 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.
  7. Read the result: Import completed: N inserted, N updated, N skipped, N errors. with a table of anything that went wrong.
Fix errors in the file and validate again

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.

Get locations right first

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

  1. Location Hierarchy
  2. Suppliers / Vendors
  3. Item Master
  4. Item-Supplier Links and Barcodes
  5. Location Min / Max Levels
  6. Opening Stock

Importing by UPC

Section 94 · Catalog setup · 6 min
Goal: Create or update many items at once from a list of retail barcodes, review what the product database returns, and merge it into existing items safely.

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

  1. Paste the codes under Paste UPCs / EANs (one per line). Commas and semicolons also separate codes. A chip counts them.
  2. 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.

Table: Action, Effect
ActionEffect
CreateA new item with this code as its barcode.
Update existingChanges the matching item. Press Review & merge to choose field by field; the button turns to Reviewed.
SkipLeaves 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.

Clean up afterward

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

Section 95 · Locations · 7 min
Goal: Read the location tree, find any location, and understand who can add, change and remove locations.

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.

Inventory Locations showing the location tree with regions, warehouses and their stock counts
Location Management. The tree of every place stock can sit. Location names here are fictional.

The header buttons

Table: Button, What it does, Who sees it
ButtonWhat it doesWho sees it
Hierarchy chartOpens 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 whatOpens 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 LocationAdds 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.
Move the stock before you remove a location

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.

Get locations right before loading stock

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

Section 96 · Locations · 9 min
Goal: Create a location with the right switches, so it shows up in the right pickers and carries the right finance details.

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

Table: Field, What to enter
FieldWhat to enter
NameRequired, up to 200 characters.
Location TypeOptional, from your workspace's list of types (Warehouse, Clinic, Fridge…).
TierNo 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 LocationThe 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.
DescriptionUp to 500 characters. Searchable in the tree.
Adding under a location fixes the parent

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):

Table: Field, What it is for
FieldWhat it is for
NotesOperational notes visible during transfers. Up to 1,000 characters.
Delivery InstructionsInstructions for shipment and receiving, such as a loading-dock door.
Ship-To location or Finance Ship-To CodeThis 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 centrePurchases received here are charged to it. Blank uses the nearest parent's.
Finance locationYour 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

Table: Switch, Turn it on when…, What it changes
SwitchTurn it on when…What it changes
Storage-enabledStock 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 mapOn by default.Draws a map on the location's panel. Switch it off for spots inside a building.
ActiveEdit 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.

Ship-to and storage do not mix

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.

Configure map leaves without saving

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

Section 97 · Locations · 8 min
Goal: Read everything about one location, see its stock, and manage the people and companies assigned to it.

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.

A selected location showing notes, delivery instructions, address, ship-to location and the stock held there
The location panel. Select a location to see its details and everything stored in it.

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:

Table: Icon (tooltip), What it does
Icon (tooltip)What it does
Edit locationOpens the edit dialog.
Add sub-locationOpens the add dialog with this location as the parent.
Configure mapOpens the map and floor-plan page.
DeactivateRemoves 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.

Table: Column, What it shows
ColumnWhat it shows
ItemThe item name; click to open the item.
SKUYour item code.
WhereHere, or the name of the shelf or room inside this location, plus any storage area.
On Hand, Reserved, AvailableAvailable turns red at zero or below.
StatusOut (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)).

  1. Search in Add company and press Add. Only active companies not already assigned are offered.
  2. 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.
  3. 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.

Admin & manager note

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

Section 98 · Locations · 10 min
Goal: Set when a facility orders, what it may order, and the stock levels it is judged against.

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).

Table: Field, What it sets
FieldWhat it sets
FrequencyWeekly or Monthly.
Every N weeks / Every N months1 to 52. Every 2 weeks means a fortnightly order.
Order day / Day of monthThe weekday, or a day from 1 to 31.
Starts, Ends (optional)When the schedule runs. Start is required.
Remind days before0 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.
EnabledSwitch 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.

Template-only with no template blocks all ordering

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.

  1. Search in Add an item that may not be ordered here… (assets are not offered).
  2. Optionally type a Reason (optional, shown to requesters), such as Order through the regional depot.
  3. 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.

Table: Part, What it does
PartWhat it does
RowsItems stocked directly at this location, plus any item that already has levels set here.
On handRed when out or below min, amber at or below reorder.
Min, Reorder, MaxType a number, or leave blank to use the item default.
Planning columns switchAdds Order multiple, Lead days and Safety days.
Set here, Low / out switchesShow only rows with levels set here, or only low and empty rows.
Cross on a rowClears 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 levelsSaves 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

Section 99 · Locations · 6 min
Goal: Use the hierarchy chart to see the whole structure, find where an item is stocked, and share it as a 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

Table: Control, What it does
ControlWhat it does
Find a locationSearches 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 itemLists 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, InactiveShow or hide those boxes, starting from the page's own filters.
Expand all, Collapse allOpen or close every branch.
Download PDFOpens the PDF dialog (below).
Zoom − and +, the percentage, FitZoom; 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.

  1. In Start from, pick a location, or leave it empty for the whole workspace.
  2. Choose whether to Include storage spots (shelves, fridges and bins).
  3. Leave Add a list of every location with its address on for the address list.
  4. Press Download PDF. Tansi reports the file name and how many locations it contains.
Use the chart to answer where is it?

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

Section 100 · Locations · 5 min
Goal: Pin a location on the world map and place its rooms and shelves on a floor plan.

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 has no confirmation

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.

  1. Click a location in the list. Tansi says Click on the canvas to pin …
  2. Click the spot on the plan. Or type X % and Y % (0 to 100) and press Set pin.
  3. To adjust, drag the pin, or select it and use the arrow keys (hold Shift for bigger steps).
  4. 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

Section 101 · Locations · 9 min
Goal: Follow realistic location set-ups from start to finish and apply them to your own workspace.

1 · A new warehouse with shelves (warehouse)

  1. On Location Management, select the region and press Add sub-location.
  2. Name it Kamloops Warehouse, type Warehouse, Tier 2. Open the address and enter it.
  3. 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.
  4. Open Show Operational Details and add Dock door 3, 7 a.m. to 3 p.m. to Delivery Instructions. Press Create.
  5. 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.
  6. 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.

  1. Create Yard as a root location with an address and Receives shipments on.
  2. 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.
  3. Under each site add Tool container with Storage-enabled on.
  4. On each site's panel, use Assigned Companies to add the subcontractor and tick the foremen who should see the container's stock.
  5. 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)

Not only for health care

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.

  1. Select the health center. Under Ordering Schedule press Set up schedule.
  2. Choose Weekly, Every N weeks 2, Order day Monday, Remind days before 2.
  3. Add a blackout for the winter holiday week and press Save schedule.
  4. Under Request templates, link Clinic standard order; it becomes the default.
  5. Open Min / Max levels, set Min, Reorder and Max for the top items, and press Save levels.
  6. 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)

  1. Create Convention Center with its address, then Hall A storage, Loading bay and AV room inside it, each storage-enabled.
  2. Press Configure map on the convention center and drop a pin on the world map.
  3. Upload the venue's floor plan PDF and pick page 2, the ground floor.
  4. Select each room in Locations on this floor plan and click its spot on the plan.
  5. Crew opening an item that is stored there can now see where in the building it is.

5 · Retiring an office storeroom (office)

  1. 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.
  2. Check the storeroom's panel shows No items are stocked at this location.
  3. 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

Section 102 · Order feedback surveys · 5 min
Goal: Understand what an order feedback survey is for, how it moves through its stages, and find your surveys.

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.

Order Feedback with counters, a search box, status chips and an empty survey table
Order Feedback. Surveys sent to sites before purchase drafts are created.
Not only for health care

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

Table: Stage, What it means, How it gets there
StageWhat it meansHow it gets there
DraftBeing set up. Responders cannot see it yet.New Feedback Survey, or a copy with Use as template.
ActiveSent. Responders can answer from the start date.Activate & Send.
ClosedNo more answers. Vendor drafts can now be created.Close Survey.
CompletedFinished 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

Section 103 · Order feedback surveys · 8 min
Goal: Set up a survey with dates, suggested items and responders, each with the right destination.

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

Table: Field, Notes
FieldNotes
TitleRequired.
DescriptionShown to responders. Say what the order is for and when it will be placed.
Start DateOptional. Cannot be in the past. Responders cannot answer before it.
End DateOptional due date. Cannot be before the start date or in the past.
Allow edits before deadlineLets responders change a submitted answer until the end date.
Old start dates stop a save

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.

Table: Button or column, What it does
Button or columnWhat it does
Load inventoryOpens the catalog browser to pick many items at once. Setting an already-suggested item to zero there removes it.
Add another itemAdds a row; search by item name or SKU. An item can only be suggested once.
Bulk scanScan barcodes one after another. Items outside the survey's catalog are skipped and counted.
RequiredStar this item so stations see it as expected. Starred items show a gold star to responders.
Delete iconRemoves 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.

Plan for several sites

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

Section 104 · Order feedback surveys · 9 min
Goal: Send a survey, follow responses, close it and create draft purchase orders from the totals.

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

Table: Button, Shown when, What it does
ButtonShown whenWhat it does
EditDraftOpens the editor.
Activate & SendDraftMakes the survey active. Recipients can access it from My Order Feedback; in-app notifications are sent best-effort.
Enter My FeedbackActive, and you are a responder who has not submittedOpens your own answer page.
Use as TemplateAlwaysCopies it to a new draft named … - Copy and opens the copy.
Close SurveyActiveStops further answers.
Mark CompleteClosedFiles the survey as done.
Create Vendor DraftsNot DraftEnabled only when Closed or Completed, with submitted quantities.
Export Summary, Export DetailNot DraftDownload Excel workbooks of the totals and of every answer.
No confirmation on stage changes

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:

Table: Tab, What it shows
TabWhat it shows
Item TotalsEach item with total quantity and number of responses.
By LocationThe same totals per destination location.
Site ResponsesEach responder: location, status, when submitted, how many items and total quantity.
Purchase PlanTotals grouped by each item's preferred supplier. A group is marked Preferred vendor, or Needs vendor when its items have none.
Totals include unfinished answers

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

  1. Close the survey.
  2. Press Create Vendor Drafts.
  3. 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.
  4. 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.
  5. Tansi reports Created N purchase draft(s). and opens the first draft. Find the others in My Requests.
  6. Add the delivery location, prices and anything else, then submit each draft for approval as usual.
Press Create Vendor Drafts once

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

Section 105 · Order feedback surveys · 6 min
Goal: Find the surveys sent to you, enter the quantities your site needs, and submit them in time.

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

Table: Column, What it shows
ColumnWhat it shows
Feedback SurveyTitle and description.
StatusThe survey's stage. A draft says Not sent yet; a survey that has not started says Opens ….
Due DateRed with (overdue) once passed.
DestinationWhere your items are going.
Your StatusNot Started, In Progress or Submitted.
Last columnA 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.
Table: Control, What it does
ControlWhat it does
Qty with − and +Whole numbers, zero or more.
SuggestedA gold star for items the buyer marked as expected, an outline star for other suggestions, Added for items you added.
NotesAn optional note per line, up to 500 characters.
Set all to 1Sets every line still at zero to 1.
ClearResets every quantity to zero.
Load inventory, Add another item, Bulk scanAdd 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.

Getting back in after submitting

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)

  1. The safety coordinator sends Winter PPE 2026 to every site foreman, with insulated gloves, toques and ice cleats suggested and starred.
  2. A foreman opens My Order Feedback, presses the pencil and enters 24 gloves, 24 toques and 0 cleats (the site has stock).
  3. He adds hand warmers with Add another item, notes Night shift crew and presses Submit Feedback.
  4. When every site has answered, the coordinator closes the survey and creates the vendor drafts.

Inventory Reports: the Dashboard

Section 106 · Reports · 8 min
Goal: Read the inventory dashboard, filter it to a period and location, and export or print it.

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.

The Inventory Reports dashboard with period, location and expiry filters, headline figures and charts
Dashboard. Headline figures and charts for the period and locations you choose. Figures here are sample values.

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

Table: Filter, Choices
FilterChoices
PeriodLast 30 days, Last 90 days (the default), Quarter to date, Year to date, Custom range (with From and To).
LocationOne location and everything inside it, or All locations.
Expiry window30, 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

Table: Figure, What it counts
FigureWhat it counts
Active SKUsItems in stock, and across how many locations.
On-hand valueStock valued at the lot's cost, or the item's purchase price when the lot has none.
Open Purchase OrdersOpen purchases, and how many are awaiting receipt.
Low / out of stockItem-and-location pairs that are low or empty.
Avg time to shipFrom submitted to shipped, with how many requests it is based on.
Avg vendor lead timeFrom sent to the supplier to received.

The cards

Table: Card, What it shows
CardWhat it shows
Most ordered productsUnits requested on supply and purchase requests submitted in the period.
Stock statusA donut of item-and-location entries by availability. Expiring means healthy but holding a lot inside the expiry window.
Vendor lead timeAverage days from sent to received, per supplier, longest highlighted.
Average time to shipHours from submitted to first shipment, by week.
Inventory value by categoryOn-hand value per category.
Requests raised vs fulfilledTwo weekly lines, with totals for the period.
Reorder alertsEvery 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 lotsLots 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

Section 107 · Reports · 8 min
Goal: Download the right printable report without building anything.

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.

The Documents tab with stock document cards for count sheet, reconciliation worksheet and transaction report, each with its own filters
Documents. Printable PDF and Excel documents, each with its own filters and a report ID you can scan to re-run it.
Table: Group, Report, Filters, What it gives you
GroupReportFiltersWhat it gives you
Stock documentsCount Sheet (Excel)LocationSystem on-hand with blank count and variance columns — take it to the shelf.
Reconciliation Worksheet (PDF)LocationPrintable count worksheet with blank physical, adjustment and reason columns.
Transaction Report (PDF)From, To, LocationReceive, issue, transfer and adjustment activity, with totals.
ReceivingWarehouse Receipts Without a Purchase Order (PDF)From, To, LocationEvery 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 operationsDaily Inventory Report (PDF)As of, LocationOn-hand rebuilt as of a past date, by item.
Daily Withdrawal Reconciliation (PDF or Excel)Withdrawal date, Location, Staff member, ItemWithdrawals 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, BreakdownDisposal 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, LocationReturn shipments sent back up the hierarchy, per line.
Expiry & lotsNearing Expiry Report (PDF or Excel)Expiring within + Unit, Location, Category, Product, Include quarantined, recalled and suspended lotsStock 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 documentsPick 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 IDThe 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 without a purchase order are watched

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)

  1. On the last day of the month, open Documents.
  2. Download the Transaction Report (PDF) for the month for each warehouse.
  3. Download Warehouse Receipts Without a Purchase Order (PDF) for the same dates and send it to finance.
  4. Set the Nearing Expiry Report to 2 Months, download the Excel, and press Open on lots board to act on it.
  5. 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

Section 108 · Request setup · 6 min
Goal: Find every request-setup page, know which permission opens each one, and know where each page lives.

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.

Requests Admin with cards for approval workflows, route map, routing rules, DOFA, delegations, designated approvers, forms, templates, settings and branding
Requests Admin. Everything that decides how requests are approved and named.

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.

Table: Tile, What it is for, Permission that opens it
TileWhat it is forPermission that opens it
Approval WorkflowsThe step-by-step routes a request follows.Approval workflows
Route mapEvery kind of request and the route it takes, in one chart.Routing rules
Routing RulesThe ranked list of rules choosing a workflow.Routing rules
DOFA ThresholdsAmount tiers for goods and services.Approval workflows
DOFA AuthoritiesImported table of who may approve invoices, per cost center.Approval workflows
DelegationsOne person covering another's approvals for a while.Delegations
Designated ApproversEach user's go-to approver.Approval workflows
Creation FormsForms to complete before a request is submitted.Creation forms
Form DefinitionsThe form templates (not built yet, see later).Creation forms
Request TemplatesReusable starting points for new requests.Manage templates
Request SettingsNames, page names, reminders, ordering rules, purchasing, invoices, finance codes, auto-save.Approval workflows
BrandingThe logo printed on documents.Approval workflows
Request PermissionsWho may create and approve requests.Roles (Admin)
Admin & manager note

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

Table: Page, Address, What it is for
PageAddressWhat it is for
Requests Admin/requests/adminThe tile hub.
Approval Workflows/requests/admin/workflowsList of workflows, coverage per type.
New / edit workflow/requests/admin/workflows/newThe workflow builder.
Route map/requests/admin/route-mapRows in checking order, with their routes.
Routing Rules/requests/admin/routing-rulesRead-only ranked list of rules.
DOFA Thresholds/requests/admin/dofaAmount tiers and the workflow each uses.
DOFA Authorities/requests/admin/dofa-authoritiesImported invoice approval authority.
Approval Delegations/requests/admin/delegationsCover for absent approvers.
Designated Approvers/requests/admin/designated-approversGo-to approver per user.
Creation Forms/requests/admin/creation-formsForms required before submit.
Form Definitions/requests/admin/form-definitionsPlaceholder page.
Request Settings/requests/admin/settingsWorkspace-wide request settings.
Branding/requests/admin/brandingDocument logo.
Warehouse Queue/warehouse/dashboardPick, 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

Section 109 · Request setup · 5 min
Goal: Read the Approval Workflows list, check every request type is covered, and create, clone or delete a workflow.

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.

Approval Workflows with per-type coverage tiles and the workflow table with scope, applies to, steps and active columns
Approval Workflows. Coverage by request type, then every workflow with its steps.

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.

Table: Column, What it tells you
ColumnWhat it tells you
NameWith its description and a step count, plus includes forks when the route splits somewhere.
ScopeTenant (yours) or Global.
Applies toThe request types it is for, or All types.
StepsHow many steps it has.
ActiveYes or No. Only active workflows route requests.

The export menu downloads the rows you see.

Row actions

Table: Icon, What it does
IconWhat it does
EditOpens the workflow builder. Shown for your workspace's own workflows.
Clone to my tenantOn 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.
DeleteAsks Delete Workflow? and warns This action cannot be undone.
Start from a global workflow

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

Section 110 · Request setup · 10 min
Goal: Use the one-screen workflow builder: describe the workflow, add and arrange steps, read the problems bar, save, and turn the workflow on or off.

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

Table: Button, What it does
ButtonWhat it does
SaveStores 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 onSaves 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 offSaves 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.

Changes are only kept when you save

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.

A workflow that is on must stay valid

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:

Table: Field, What it means
FieldWhat it means
NameRequired, up to 200 characters.
DescriptionUp to 1,000 characters.
Applies to request typesPick one or more; Leave empty for all types.
Resulting documentThe document the request produces: PurchaseOrder, Contract or APDirectPayment.
Use as default workflow when no routing rule matchesThe 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.

Admin & manager note

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

Section 111 · Request setup · 10 min
Goal: Choose the right kind of step, say who it goes to, and set the decision rule, chasing, notifications, forks and endings.

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

Table: Kind, What it does
KindWhat it does
ApprovalOne or more people approve or reject it.
Fill in a formSomebody completes a form before the request moves on.
A fork in the roadSend it down different paths depending on the request.
Pick it in the warehouseWarehouse staff pick the items against the request.
Pack and shipPack, label and hand it to the carrier.
Receive itThe requester confirms what turned up.
Tell somebodyA message goes out. Nothing waits for it.
The endThe 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).

Table: Choice, Who that is, Offered for
ChoiceWho that isOffered for
A named personOne 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 roleEverybody 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 approverRead from the requester's profile when the request runs. Set it in Designated Approvers.Approval, Tell somebody, Form
The requester's managerRead from the requester's profile when the request runs.Approval, Tell somebody, Form
The warehouse team for the locationThe team assigned to the warehouse chosen in Which warehouse.Approval, Tell somebody, Pick, Pack, Receive
The requesterWhoever 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.

A role at one place can reach nobody

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

Table: Setting, What it means
SettingWhat it means
How the decision is madeAny 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 chasedAfter this many days the approvers are reminded. Leave empty and nobody is chased.
Honour delegationsIf the approver has someone covering them, the stand-in can approve.
They can send it backReturned 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

Section 112 · Request setup · 9 min
Goal: Decide which requests use which workflow with routing rules, read the order Tansi checks them in, and change it safely on 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 Route map listing each kind of request in order, the workflow it goes to and its steps
Route map. Tansi checks the rows from the top; the first row that fits decides the route.

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.

Table: Field, What it matches
FieldWhat it matches
Priority (higher wins)Its place in the checking order.
ActiveOnly active rules are checked.
Match request typeOne type, or empty for any.
Match locationRequests for one location.
Supplied byRequests from places this warehouse supplies: inside it, or ordering from it through a sharing rule.
Min estimated value / Max estimated valueA value band.
Restricted itemsRestricted only, Exclude restricted or Ignore (any).
ReturnsReturns only, Exclude returns or Ignore (any).
Not-allowed item overridesRequests 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.

Table: Control, What it does
ControlWhat it does
Goes toSwitch the row to another active workflow. Saved at once.
Up / down arrowsCheck this row earlier or later (swaps it with its neighbor).
Tune iconChange which requests this row covers (opens the rule dialog).
Red power iconSwitch 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.

A new row is checked first

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.

Routes are shared

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.

Restricted does not have to mean medical

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

Section 113 · Request setup · 8 min
Goal: Maintain the amount tiers that pick an approval workflow by value, test an amount, and understand how the imported authority table controls invoice approval.

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.

Table: Column, What to enter
ColumnWhat to enter
#The row's place. Rows are checked top to bottom.
Min Amount / Max AmountThe band. Max blank means unlimited.
Item TypeBoth, Goods or Services.
Approval WorkflowRequired. Start typing to pick an active workflow by name.
Required DocumentsFree text, for example Quote, PO.
DescriptionA note for other admins.
ActiveOnly active rows are used.
ActionsMove 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.

Test after you save

Match tests the saved table, not the edits on screen. Save first, then test.

Workflows are linked by name

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.

Admin & manager note

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

Section 114 · Request setup · 8 min
Goal: Set each person's go-to approver, add per-type alternates, and cover an absent approver with a delegation.

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.

Table: Column, What it is for
ColumnWhat it is for
Expand arrowOpens the user's alternate approvers (below).
UserThe requester. A chip such as 2 alts counts their alternates.
EmailTo tell people with the same name apart.
Designated approverPick from every other active user, or — None —.
Save / checkA 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.

Unsaved default is saved first

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.

Table: Column, What it shows
ColumnWhat it shows
DelegatorThe person being covered.
DelegateThe person covering.
Start / EndThe dates.
StatusScheduled (not started), Active, Expired or Revoked.
ReasonWhy, if given.
  1. Press New Delegation (or Create first delegation on an empty page).
  2. Search for the Delegator (who is being covered) and the Delegate (who will cover). They must be different people.
  3. Set Start date and End date. They start as today and two weeks from today. The end cannot be before the start.
  4. 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.

A delegation only works where the step allows it

The stand-in can approve only on workflow steps with Honour delegations ticked. Delegations also count for invoice approval under DOFA Authorities.

Admin & manager note

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

Section 115 · Request setup · 5 min
Goal: Require a form before a request is submitted, know what the Form Definitions page does today, and set the logo printed on request documents.

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.

Table: Column, What it shows
ColumnWhat it shows
NameWith its description.
Request typeThe type it applies to.
Form definitionThe form people fill in.
ScopeTenant (yours, editable) or Global (read-only).
RequiredRequired or Optional.
OrderThe 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.

  1. Drag an image onto Upload a logo, or click browse. JPG, PNG, GIF or WebP, up to 5 MB.
  2. 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.
  3. 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 does not ask

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

Section 116 · Request setup · 8 min
Goal: Rename request types and pages for your workspace, add a reminder before submit or approve, and decide whether one request may mix categories.

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.

Request Settings on the Names section with singular and plural names for each request type
Names. This workspace calls purchase orders Requisition Orders. Numbers keep their prefix whatever the name.
Request Settings on the Page names section with Shown as fields for Withdraw Supplies and Withdraw for Delivery
Page names. Rename Withdraw Supplies, for example to Dispense, and the menu, page and buttons follow.

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.

Numbers keep their prefix

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.

Name pages in your team's words

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.
Any categories, not only medical ones

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

Section 117 · Request setup · 8 min
Goal: Set how purchase orders are labeled and sent, how receipts without a PO and returns are held, how invoices are matched, which finance codes apply by default, and auto-save.

Purchasing

Purchase order fields and where purchase orders are sent.

Table: Setting, What it does
SettingWhat it does
Finance system PO numberWhat 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 handOn: 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 holdOn: 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 fieldWhat 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 contractWhen 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 mailboxAn 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

Section 118 · Request setup · 10 min
Goal: Follow four complete admin set-ups: a simple manager approval, a value-based fork, a warehouse route with picking and receiving, and holiday cover.

1. Office: every supply request approved by the requester's manager

  1. On Approval Workflows, click the Supply coverage tile. A starter workflow opens, named Supply approval.
  2. 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.
  3. Press Edit these and tick Use as default workflow when no routing rule matches. Save the dialog.
  4. Check the problems bar is clear, then press Turn it on.
  5. 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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. Edit Director sign-off: When this step is done, go to the End step.
  6. 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

  1. Click the Transfer coverage tile on Approval Workflows to start a transfer workflow (or clone a global one with Clone to my tenant).
  2. Press Add a step: Pick it in the warehouse (warehouse: The warehouse it ships from). Tick Part shipments allowed if partial loads are acceptable.
  3. 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.
  4. Edit the final step and set its Outcome to Fulfilled. Save, then Turn it on.
  5. 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

  1. On Approval Delegations, press New Delegation. Delegator: the pharmacy lead. Delegate: the deputy. Dates: the two weeks. Reason: Annual leave. Create.
  2. Check that the approval steps the lead handles have Honour delegations ticked.
  3. 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.
  4. When the lead is back, the delegation shows Expired by itself; nothing needs undoing.
Not limited to health care

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

Section 119 · Shared controls · 9 min
Goal: Use the location, storage spot, department and product pickers confidently, and know what the item labels and warning dialogs mean.

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

Table: Label, Meaning
LabelMeaning
CriticalCritical item — keep it in stock and report shortages right away.
ControlledControlled item — extra approval or handling rules apply. The tooltip shows the reason when one is set.
Storage type, such as RefrigeratedStore as: …
High riskHigh-risk item — handle with care and follow its safety sheet.
HazardousA hazardous item (shown in pickers).
SDSA Safety Data Sheet applies to this item.
Safe handlingA safe-handling procedure applies; the tooltip names it.
6 h once open (for example)Use within 6 hours of opening.
Credit returnThe 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

Table: Dialog, When it appears, What to do
DialogWhen it appearsWhat to do
Inventory warningYou 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 warningsSeveral items on one receipt have warnings. Items with the same warnings are grouped.Press Acknowledge all (N), or Cancel.
Lot status warningA 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

Section 120 · Reference · 5 min
Goal: Use this index to find any page in Assets & Inventory, where it sits in the menu, and what it is for.

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.

Table: Page, Address, Where in the menu, What it is for
PageAddressWhere in the menuWhat it is for
Hub/requestsAlways shownThe Requests hub: counters, shortcuts and your work queues.
Withdraw Supplies/inventory/withdrawAlways shownRecord supplies taken, dispense multi-use units and see waste. Often renamed, for example Dispense.
Move Stock/inventory/move-stockAlways shownMove stock between storage spots inside one location, immediately.
Receive Deliveries/admin/inventory/inboundAlways shownDeliveries coming to your location (same page as Inbound Deliveries).
Item Master/admin/inventory/itemsStockYour product and asset catalog.
Item page/admin/inventory/items/{id}From the Item MasterOne item: stock, history, lots, documents and safety.
New item / Edit item/admin/inventory/items/create, /admin/inventory/items/edit/{id}From the Item MasterCreate or change an item.
Stock Levels/admin/inventory/stockStockOn hand, reserved and available across every location; assets.
Lots/inventory/lotsStockEvery lot, with expiry, quarantine, suspension and recalls.
Lot page/inventory/lots/{id}From LotsOne lot: where it sits, its history, and status changes.
Reserved Stock/admin/inventory/reservedStockWhat is held, and what holds it.
Returns on hold/admin/inventory/returns-on-holdStockStation returns waiting for a decision.
Stock Review/admin/inventory/reviewStockFlags raised from the Tansi Inventory app.
Critical Items/admin/inventory/criticalStockMust-never-run-out and restricted items.
Waste Management/admin/inventory/wasteStockRecord and review waste; disposal audit.
Reorder Suggestions/admin/inventory/reorderStockItems at or below reorder per location; turn them into orders.
Order Schedule/admin/inventory/order-scheduleStockWhich facilities are due to order, by calendar.
Inventory Count/admin/inventory/countStockCount stock, review differences and apply adjustments.
Exceptional receipts/admin/inventory/receive-without-poFrom the Hub and Stock LevelsDeliveries without a Tansi order, and their hold or release.
New receipt without a purchase order/admin/inventory/receive-without-po/newFrom Scan & Receive and Exceptional receiptsRecord a delivery with no Tansi order behind it.
Scan & Receive/admin/inventory/barcode-scanWarehouseScan a barcode to look up an item or open a request.
Inbound Deliveries/admin/inventory/inboundWarehouseApproved purchases and transfers awaiting receipt.
Withdraw for Delivery/inventory/withdraw-deliveryWarehouseShip stock to departments or places with nobody on Tansi to receive it.
Transaction History/admin/inventory/stock/historyWarehouseThe stock ledger: every movement in and out.
Warehouse Queue/warehouse/dashboardFrom the HubPick, pack and ship request work.
Warehouse work order/warehouse/work/{id}From the Warehouse QueueWork one request: pick, pack and ship.
Manage Feedback/admin/inventory/order-surveysSurveysOrder feedback surveys you send to sites.
New / edit feedback survey/admin/inventory/order-surveys/new, /admin/inventory/order-surveys/{id}/editFrom Manage FeedbackSet up a survey's dates, items and responders.
Feedback survey page/admin/inventory/order-surveys/{id}From Manage FeedbackSend, follow, close and turn a survey into vendor drafts.
My Order Feedback/inventory/my-surveysSurveys; also Home › My WorkSurveys sent to you.
Enter Order Feedback/inventory/my-surveys/{id}From My Order FeedbackEnter and submit your site's quantities.
Snapshot History/admin/inventory/reorder-historySurveys; also Admin moduleSaved snapshots of the reorder list.
Inventory Reports/admin/inventory/reportsReportsDashboard, printable documents and Ask Tansi Intelligence.
Operations Reports/reports/operationsReportsOperations reporting across requests and stock.
Audit Log/admin/inventory/audit-logReportsA read-only record of actions taken in the module.
New request/requests/new, /requests/new/wizardFrom the HubSearch for an item and get the right kind of request suggested.
New request editor/requests/new/{type}From the HubA blank supply, purchase, transfer or return draft.
Request page/requests/{id}From any request listOne request: stage, items, approval, filling, documents and history.
Edit draft/requests/{id}/editFrom a draft requestThe editor for a saved draft.
Request lists/requests/list, /requests/list/mine, /requests/list/supply, /requests/list/transfers, /requests/list/purchases, /requests/list/returnsFrom the HubAll requests, your own, or one kind.
Approval Inbox/requests/inboxFrom the HubEverything waiting for your decision.
Request Templates/requests/templates, /requests/templates/new, /requests/templates/{id}/editFrom the HubReusable request templates.
Bulk import/requests/importFrom the HubCreate supply requests from a CSV or Excel file.
Return label/requests/{id}/return-labelFrom a return requestA printable label for a return to the warehouse.
Categories/admin/inventorycategoriesAdmin; also Admin moduleThe category tree items are filed under.
New / edit category/admin/inventorycategories/create, /edit/{id}; /admin/inventorysubcategories/create, /edit/{id}From CategoriesCreate or change a category or child category and its fields.
Suppliers/admin/vendorsAdmin; also Admin moduleYour supplier list.
Contracts/admin/vendors/contractsAdmin; also Admin moduleSupplier contracts.
Carriers/admin/inventory/carriersAdmin; also Admin moduleShipping carriers, accounts and service levels.
Custom Dropdowns/admin/customdropdowncategoryAdmin; also Admin moduleNamed lists of values for category fields.
Custom dropdown pages/admin/customdropdowncategory/create, /edit/{id}, /details/{id}From Custom DropdownsCreate a list, rename it, and manage its values.
Workspace Lists/admin/inventory/listsAdminWorkspace-wide lists such as departments.
Location Management/admin/inventory/locationsAdmin; also Admin moduleThe location tree, each location's rules, people and stock.
Map Setup/admin/inventory/locations/{id}/mapFrom Location ManagementA location's map pin, floor plan and pins for what is inside it.
Request Settings/requests/admin/settings, /requests/admin/namingAdmin; also Admin moduleRequest names, page names, reminders, purchasing and finance settings.
Requests Admin/requests/adminFrom the Hub (Settings)Configure workflows, routing, delegations and forms for purchase, transfer and supply requests.
Approval Workflows/requests/admin/workflowsFrom Requests AdminOrdered step sequences that approve purchase, transfer and supply requests.
New / edit workflow/requests/admin/workflows/new, /requests/admin/workflows/{id}/editFrom Approval WorkflowsEverything a request goes through, written out and drawn.
Route map/requests/admin/route-mapFrom Requests AdminWhere each kind of request goes, in the order Tansi checks.
Routing Rules/requests/admin/routing-rulesFrom Requests AdminRanked rules: the first match decides the workflow.
DOFA Thresholds/requests/admin/dofaFrom Requests AdminApproval thresholds under your delegation of financial authority.
DOFA Authorities/requests/admin/dofa-authoritiesFrom Requests AdminWho may approve vendor invoices, per cost center and up to what amount, imported from your finance system.
Approval Delegations/requests/admin/delegationsFrom Requests AdminCover one person's approvals with another for a date range.
Designated Approvers/requests/admin/designated-approversFrom Requests AdminSet each person's go-to approver.
Creation Forms/requests/admin/creation-formsFrom Requests AdminForms that must be completed before a request can be submitted for approval.
Form Definitions/requests/admin/form-definitionsFrom Requests AdminReusable form templates used by creation forms and workflows.
Branding/requests/admin/brandingFrom Requests AdminThe logo printed on purchase orders, packing slips, receiving reports and request printouts.
Request Permissions/admin/inventory/request-permissionsAdmin; also Admin moduleWho may create and approve inventory requests.
Access Center/admin/access-centerAdmin; also Admin moduleWho can see which locations, and sharing between them.
Data Import/admin/inventory/importAdmin; also Admin moduleBring items, stock and more in from a spreadsheet; UPC lookup.
Funding Sources/admin/inventory/funding-sourcesAdmin; also Admin moduleWhere the money comes from, for reporting.
Old links still work

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.

Module 07 · Bulk messaging

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

Section 0 · Getting oriented · 4 min
What you’ll get: Know what this module holds, whether you can reach it, and which of its two senders is the right one for your message.

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.

Table: Group, Menu items, What they are for
GroupMenu itemsWhat they are for
SendMass Message, Campaigns, ChatThe two senders, plus a shortcut to Chat (marked ALSO, because Chat is its own module).
AudienceLists, SubscribersThe mailing lists campaigns send to, and the people on them.
SetupCampaign Templates, Email Templates, Notification Groups, Message HistorySaved 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.
Never use Mass Message for a newsletter

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.

Admin & manager note

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

Section 1 · Getting oriented · 5 min
Goal: Recognize the words this module uses before you meet them on a screen.
Table: Term, What it means
TermWhat it means
Mass MessageThe 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.
CampaignOne email, its audience, its schedule and its results, stored as a single record you can draft, schedule, resend and report on.
Project scopeThe projects a Mass Message draws its people and templates from. Required before anything else on the page works.
Recipient tokenOne 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.
BatchA slice of a Mass Message sent together. Batches go out one after another, with a pause between them.
Quiet hoursA Mass Message option that holds the send until 7:00 a.m. local time.
Emergency broadcastA Mass Message shortcut that sets every project, every channel and everyone in the workforce. It fills the form; it does not send.
ListA mailing list people subscribe to. Campaigns send to lists; Mass Message does not use them.
SubscriberA person on one of your lists who is not a Tansi user. Underneath, a CRM contact with a list membership.
Single opt-inA public sign-up is subscribed immediately.
Double opt-inA public sign-up is subscribed only after clicking the link in a confirmation email.
PendingA double opt-in sign-up that has not been confirmed yet. Shown as Awaiting confirmation. Never sent to.
SuppressionA workspace-wide block on one email address after an unsubscribe from everything, a hard bounce or a spam complaint.
Public sign-up formThe page at /subscribe/… where anyone with the link can join a list.
EmbedPutting a list's sign-up form on your own website with a short code snippet.
Consent recordThe stored proof of a public sign-up: the exact sentence shown, the page, the address, the time and, once confirmed, the confirmation time.
Campaign templateA saved campaign design, made with Save as template in the campaign designer.
Email templateA template for one of the system's own emails, such as a recall notice or a hiring notice. Unrelated to campaigns.
Notification groupA named, reusable group of people. Mass Message can target one; campaigns cannot.
Message HistoryThe delivery log for Mass Message and every system notification.
Origin chipThe CRM or Mass Communication label under a campaign's name, showing where it was created.

Mass Message or Campaigns?

Section 2 · Getting oriented · 5 min
Goal: Choose the right sender for any message, and explain why the choice matters.

Use this table whenever you are about to send something to more than a handful of people.

Table: , Mass Message, Campaigns
Mass MessageCampaigns
Who it reachesYour workforce: people in your projects, groups, companies, roles, duties and locationsSubscribers on your lists, Tansi users and pasted addresses
ChannelsEmail, SMS / MMS and in-app pushEmail only from this module
How you write itA rich-text editor per channelThe block canvas designer
Saved as a draftNo — close the page and it is goneYes — edit, schedule, cancel, duplicate, resend
TrackingNoneOpens, clicks, bounces, unsubscribes, polls
Unsubscribe link and mailing addressNoneAdded to every email, automatically
Honors opt-outsNoYes, checked again at the moment of sending
Where results appearMessage HistoryThe campaign's own report
Merge tokens{{first_name}}, {{last_name}}, {{company}}, {{role}}, {{duty}}, {{project}}{FirstName}, {LastName}, {CompanyName}
LanguagesEnglish screens onlyEnglish, French and Spanish screens
A quick rule

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.

Merge tokens do not cross over

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.

Texting from this module

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.

The Mass Message page. The header has a red Emergency broadcast button and links to Notification Groups and Message History. The left column holds a Projects card with a Select project(s) dropdown, a Channels card with Email ticked and SMS / Text and In-App Push unticked, and a Recipients card with a search box, four count tiles and filter chips reading All, Employees, Contacts, No email and No mobile. The right rail, Batching and Delivery, shows Batch size presets, a Pause between batches select, a plan summary and four switches.
Pick the projects first. Until at least one project is chosen, the recipient search stays empty and the send button stays disabled.

Mass Message: projects, channels and recipients

Section 3 · Mass Message · 9 min
Goal: Scope a Mass Message to the right projects, choose its channels and build a recipient list you can trust.

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.

English only

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.

  1. Select Select project(s)… to open the picker.
  2. Search by name or status, then tick one or more projects — or tick ALL PROJECTS — whole directory.
  3. 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.

Changing the scope can clear your template

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:

Table: You pick, It reaches
You pickIt reaches
A personThat one worker.
A notification groupThe active members of that group.
A companyThe people of that company in scope.
A roleEveryone with that job title in scope.
A dutyEveryone assigned that duty.
A locationEveryone at that location.
A typed email address or phone numberThat 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.

Two things you cannot undo on this list

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.

Check the No email and No mobile chips

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

Table: You see, Because
You seeBecause
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 tileThat 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

Section 4 · Mass Message · 9 min
Goal: Write one message that reads well by email, by text and as an in-app notification, with the right attachments and merge fields.

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.

The Message card of Mass Message. A Template dropdown reading No template, write from scratch, then tabs for Email, SMS, In-App and Attachments. The Email tab shows From (sending identity) with Department, Name and Email fields, Reply-to with the same three fields, a Subject box, insert buttons for First name and Project, and a rich-text editor. On the right, Preview message, Send test to me and Save as template buttons.
Write it once. Each channel has its own tab, and a tab is disabled while its channel is switched off.

Email

Table: Field, What it does
FieldWhat 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-toDepartment, Name and Email. Where replies go, so the message is not a no-reply. The Email field sets the actual reply address.
SubjectWith + First name and + Project insert buttons.
BodyA 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.
Inserts go at the end

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 choice has no effect

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.

Only the title and body are sent today

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.

Check the failure reasons after sending

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.

The template is the only thing that survives

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.
Templates cannot be edited or deleted

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

Section 5 · Mass Message · 8 min
Goal: Plan how a Mass Message goes out, test it safely and send or schedule it.

Batching & Delivery

Table: Control, Default, What it does
ControlDefaultWhat it does
Batch size50How many messages go in each batch. Presets 25, 50, 100, 250 and All; 0 sends everything as a single batch.
Pause between batches30 secondsNo pause, 15 seconds, 30 seconds, 1 minute, 5 minutes or 15 minutes.
Stop on failure thresholdOnHalts the run if a batch has more than 10% bounces. Only checked between batches.
Suppress duplicatesOnShown for reassurance. Duplicates are always merged, whatever this switch says.
Respect quiet hoursOffWith 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 laterOffReveals 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.

Messages count channels, not people

300 people on all three channels is 900 messages — 18 batches of 50, about nine minutes with a 30-second pause.

Quiet hours delays everything

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.

A test is a real send

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: …

When quiet hours applies

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

  1. Select Review & Send (or Review & Schedule when a time is set).
  2. Check the plan and the Send time in the dialog.
  3. Select Send now or Schedule send.
  4. 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.

Nothing can be canceled

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.

It replaces what you had

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

Section 6 · Campaigns · 6 min
Goal: Know what is the same and what is different when you build a campaign from this module.

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.

The Campaigns page in Mass Communication, subtitled Email your users and subscribers. A toolbar with search, Channel, Status, a Created date and a Show archived switch, above a table of campaigns with Name, Status, Audience, Opens, Clicks, Sent and Sent by columns. Every name in this workspace carries a CRM chip.
One pool, two doors. Campaigns created in the CRM appear here with a CRM chip, and campaigns created here appear in the CRM with a Mass Communication chip.
Table: , From Mass Communication
From Mass Communication
SubtitleEmail your users and subscribers
Audience sourcesSubscriber lists (each shown with its subscribed count), Or paste email addresses, and Tansi users
ChannelEmail only — there is no channel choice
CRM record typesNot offered (no Leads, Contacts or Event attendees)
The listThe whole workspace pool, with a CRM or Mass Communication chip under each name
A campaign that reaches CRM peopleRead-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
Your access decides, not the menu

If you hold both CRM administration and Mass Communication access, you see every audience source and the channel choice from either menu.

Notification groups are not an audience here

A carefully built notification group will not appear in the campaign editor. Campaigns reach lists, Tansi users and pasted addresses only.

Duplicating from the report stamps CRM

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

Section 7 · Audience · 9 min
Goal: Create a list with the right opt-in, publish its sign-up form, and know what archiving really does.

Lists holds your mailing lists, subtitled Groups of subscribers you can send campaigns to.

The Lists page, subtitled Groups of subscribers you can send campaigns to, with a New list button. The table has List, Opt-in, Subscribers, Unsubscribed, Public sign-up form and Last campaign columns and reads No lists yet: create a list, then add or import the people you want to email.
Start here. Subscribers and imports both need at least one list to exist.
Table: Column, Shows
ColumnShows
ListThe name, linking to Subscribers filtered to this list, with the description underneath.
Opt-inSingle or Double.
SubscribersPeople subscribed to the list.
UnsubscribedPeople who left the list.
Public sign-up formOn with a Copy link button, or Off.
Last campaignThe date of the latest campaign that drew anyone from this list.
ActionsShare & embed, Edit and Archive.
The two counts can look short

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

  1. Select New list.
  2. 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.
  3. Choose the Opt-in: Single — people are subscribed right away or Double — people confirm by email first.
  4. Turn on Public sign-up form if people should be able to join from a link.
  5. Select Save.
The New list dialog. A required List name box with a 0 of 150 counter, a Description box, two Opt-in choices — Single, people are subscribed right away, and Double, people confirm by email first, which is selected — a hint that the setting applies to the public sign-up form only, and a Public sign-up form switch. Cancel and Save buttons at the bottom.
Double is pre-selected. The choice governs every public sign-up from then on, so check it before you save.
Opt-in applies to the public form only

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.

Admin & manager note

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 sign-up link cannot be replaced

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.

There is no restore

No screen shows archived lists, so archiving is permanent in practice. Its opt-outs still count, which is what you want.

Subscribers

Section 8 · Audience · 8 min
Goal: Read a subscriber's status correctly, add someone by hand, and remove someone without erasing an opt-out.

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.

The Subscribers page, subtitled People on your lists who aren't Tansi users, with Import CSV and Add subscriber buttons. Add subscriber is grayed out. A search box and List and Status filters sit above a table with Name, Email, Lists, Status and Added columns, reading No subscribers found.
Add subscriber waits for a list. It stays disabled, with the tooltip Create a list first., until the workspace has one.

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.

Table: Status, Means
StatusMeans
SubscribedOn at least one list, nothing blocking.
Awaiting confirmationSigned up on a Double list and has not clicked the confirmation link.
UnsubscribedLeft the list, or unsubscribed from everything.
BouncedMail to the address failed permanently.
Status follows the filter, chips do not

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

  1. Select Add subscriber. It is disabled until at least one list exists.
  2. Enter the Email — a bare address, not Name <address> — and, optionally, the first and last name.
  3. Choose at least one list under Add to lists.
  4. 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.
Opt-outs follow the address

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

Section 9 · Audience · 7 min
Goal: Import a spreadsheet of subscribers accurately and lawfully.

Import CSV on the Subscribers page brings in many people at once.

The Import subscribers dialog. A Choose a CSV file button with the hint CSV with a header row, up to 10 MB and 50,000 rows, an Add to lists box reading Create a list first, a tick box reading I confirm these people agreed to receive email from us, and Cancel and Import buttons.
The tick box is the consent record. Imported people are subscribed straight away, even on a Double opt-in list.
  1. Select Choose a CSV file. It needs a header row and can be up to 10 MB and 50,000 rows.
  2. 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.
  3. Pick at least one list under Add to lists.
  4. 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.
  5. Tick I confirm these people agreed to receive email from us.
  6. Select Import.
Your tick box is the consent record

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.

Table: Good to know, Detail
Good to knowDetail
DuplicatesOnly 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.
SeparatorsCommas or semicolons, detected from the header line.
Previously unsubscribedLeft alone. An import never re-subscribes anyone.
StoppingStop keeps the rows already saved. Import the same file again to finish; nobody is duplicated.
ClosingWhile an import runs, the dialog closes only with its own button.

Messages during an import

Table: Message, Means
MessageMeans
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

Section 10 · Audience · 8 min
Goal: Know exactly what your subscribers see, and what each of their choices does.

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.

Table: What happened, What the visitor sees
What happenedWhat the visitor sees
New address, Single listYou're subscribed
New address, Double listCheck your inbox — a confirmation email is on its way
Unsubscribed before, any listCheck your inbox — they must confirm to come back
Already subscribed, bounced or complainedThe same success screen, on purpose
The page never reveals membership

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.

When someone says the email never came

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.

Some opt-outs can never be lifted

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.

Table: Where they signed up, Consent shown
Where they signed upConsent shown
The sign-up linkThe By subscribing… sentence, with no tick box
A form embedded on your websiteA required tick box: Yes, I want to receive emails from {Sender}. I can unsubscribe at any time.
A CRM lead form linked to a listAn optional tick box: Also keep me updated by email from {Sender}. I can unsubscribe at any time.
Admin & manager note

{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

Table: Page, You see, Because
PageYou seeBecause
Sign-upThis 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-upEnter your email address. / Enter a valid email address.The email is missing or badly formed.
ConfirmYour subscription is confirmedThe button was pressed in time.
ConfirmThis 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.
UnsubscribeYou've been removed from these listsThey left the listed lists.
UnsubscribeYou're unsubscribed / You're already unsubscribedThey left everything, now or earlier.

Campaign Templates and Email Templates

Section 11 · Setup · 6 min
Goal: Tell the two kinds of template apart and manage each one.

The two template pages sound alike but manage completely different things.

Table: , Campaign Templates, Email Templates
Campaign TemplatesEmail Templates
What they areSaved campaign designsThe system's own emails, such as notices and alerts
Used byThe campaign designerTansi's notification system — not campaigns, not Mass Message
Made whereIn the campaign designer, with Save as templateOn this page, with Create template
Belongs toThe workspaceA company in the workspace

Campaign Templates

The Campaign Templates page, subtitled Saved email designs to start a campaign from. A Saved templates table with Name, Created and Last changed columns reads No saved templates yet, and explains that Save as template in the campaign designer keeps a design for later.
Templates are made in the designer. This page only lists them and deletes them.

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.

No preview, no rename

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.

Admin & manager note

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

The Email Templates page, subtitled Templates belong to a company in Tansi, with Templates, Editor and Preview tabs. The Templates tab lists one row, Food Recall Notice, with key FRN, an HTML type chip, an Active status chip and Edit, Preview and Send icons. Create template and Export to Excel buttons sit above the table.
These are the system's own emails. Campaigns and Mass Message never use them.

Three tabs: Templates (name, key, type, status, and Edit, Preview and Send per row), Editor and Preview.

The Editor tab of Email Templates. Template Name, Template Key and Company fields, an Email Subject box with the hint Use double-brace variable names for dynamic content, an HTML Template switch, an HTML Content editor showing a recall summary, an Available Variables box, a Template Active switch, and Preview and Save Template buttons.
Available Variables is a note to yourself. Nothing reads it — it documents which variables the template expects.
  1. Select Create template, or the pencil on a row.
  2. Enter the Template Name, a unique Template Key and the Company it belongs to.
  3. Write the Email Subject, using double-brace variables such as {{firstName}}.
  4. Write the content in the HTML editor, or turn off HTML Template for plain text.
  5. Note the variables you used in Available Variables for whoever edits it next.
  6. Leave Template Active on and select Save Template.
Check the test address

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.

Pictures are removed

Images pasted into the HTML are stripped when you save, and a message says so. Link to images instead.

Notification Groups and Message History

Section 12 · Setup · 6 min
Goal: Keep reusable groups of people for Mass Message, and find out what was sent.

Notification Groups

The Notification Groups page with a Create group button. A filterable table with Group name, Description, Members, Created and Active columns lists two active groups, each with Edit, Manage members, Send notification, View logs, View details and Delete icons.
Groups feed Mass Message. Campaigns cannot target a notification group.

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.

Table: Row action, What it does
Row actionWhat it does
Edit groupChange the name, description and whether it is active.
Manage membersAdd or remove people.
Send notificationSend a message to only this group from here.
View notification logsMeant 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 detailsGoes to an address with no page behind it, so a not-found page appears. Use Manage members instead.
DeleteDevelopers only. Cannot be undone.

Message History

The Message History page on its SMS Conversations tab, with a Connected chip and Send SMS and Refresh buttons. Cards show each conversation's people or number, the date, a message count, the latest message and a View conversation link. Other tabs read Email Notifications, In-App Notifications, All Notifications, Alert Report and Customize Messages.
The delivery log for Mass Message. Campaign sends are not here — each campaign has its own report.

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.

The Email Notifications tab of Message History, headed Recent Email Notifications, with Send email and Refresh buttons. A table lists Date, Email address, Subject, Content, Status, Sent at and an Actions eye icon, with every row marked Sent.
Every system email, newest first. Expand a row or select the eye icon to read what was sent.
What you will not find here

Campaign sends — open the campaign's report instead — and Mass Message in-app notifications, which are not logged.

Customize Messages

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.

English only

Email Templates, Notification Groups and Message History are not translated.

Use Manage members, not the log and details buttons

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

Section 13 · Setup in depth · 8 min
Goal: Create, edit, preview and test one of the system's own email templates, and know what you cannot do on this page.

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.

Email Templates with Templates, Editor and Preview tabs and a template row with name, key, type, status and actions
Email Templates. Each template has a key that automated emails look it up by. Edit, preview or send a test from the row.

Who can do what

Table: You have, You can
You haveYou can
View access to Email TemplatesOpen the page, list templates, preview them, send a test and export to Excel.
Edit accessAlso see Create Template and the pencil on each row, and save changes.
No accessSee 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

Table: Column, Shows
ColumnShows
NameThe template's display name.
KeyIts identifier, such as FRN.
TypeHTML or Plain Text.
StatusActive or Inactive.
ActionsPencil (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

  1. 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.
  2. Fill in Template Name and Template Key (the helper calls it a Unique identifier for this template).
  3. Pick the Company it belongs to.
  4. Type the Email Subject. Variables are written in double braces, such as {{firstName}}.
  5. 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.
  6. Note the variables the template expects in Available Variables. Nothing reads this box; it is documentation for the next editor.
  7. Leave Template Active on, then select Save Template. You stay on the Editor tab.
Table: If you see, It means
If you seeIt means
Template Key is required, Template Name is required, Email Subject is requiredThat field is empty. They are checked in this order.
Template content is required / Message content is requiredThe 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 removedPictures pasted into the HTML are stripped on save. Link to images instead.
Template created successfully! / Template updated successfully!Saved.
Turning HTML off does not delete the HTML

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!

A test is sent exactly as stored

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.

There is no delete

No screen deletes an email template. To retire one, turn Template Active off and save.

Notification Groups: the list and its buttons

Section 14 · Setup in depth · 6 min
Goal: Create a notification group, use each row button correctly, and avoid the two that lead nowhere.

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.

Notification Groups with filters on each column and rows showing members, created date, status and the action icons
Notification Groups. The row icons edit the group, manage members, send, open the send log, view and delete.

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

Table: Column, Shows
ColumnShows
Group NameThe group's name.
DescriptionIts description.
MembersHow many people are in it.
CreatedThe creation date, shown day/month/year.
ActiveActive 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

Table: Button, What it does
ButtonWhat it does
Edit GroupOpens Edit Notification Group. Saving shows Group updated successfully!
Manage MembersOpens the group's members page, with tabs for members, adding people and the send log.
Send NotificationOpens Send Mass Notification for this group only. A successful send shows Notification sent successfully!
View Notification LogsGoes to the group's log page — which currently always ends on the access-denied page.
View DetailsGoes to an address with no page behind it, so you see a not-found page.
Delete GroupDevelopers only. Asks Are you sure you want to delete the group '{name}'? This action cannot be undone. and then shows Group deleted successfully!
Two buttons that do not work today

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.

Deactivate rather than delete

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

Section 15 · Setup in depth · 6 min
Goal: Add and remove group members one at a time and read the group's delivery history.

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.

Removing has no confirmation

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

  1. Type at least two characters of a name or email in Search Users to Add.
  2. Press Enter or select Search Users. Fewer than two characters shows Please enter at least 2 characters to search.
  3. Under Available Users ({n}), select the green + beside each person to add. People already in the group are left out of the results.
  4. 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.

Table: Column, Shows
ColumnShows
TypeThe channel of the message.
SubjectIts subject.
Sent DateWhen it was sent.
Total RecipientsHow many people it was addressed to.
Successful / FailedHow many sends worked and how many did not.
StatusSent or Delivered in green, Failed in red, Pending in amber.
DetailsOpens 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

Section 16 · Message History · 9 min
Goal: Find any text, email or in-app notification Tansi sent, read it in full, reply to a text conversation and retry a failed email.

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.

Table: On a card, Means
On a cardMeans
Name and numberThe person, with the raw number underneath when a name is known.
DateThe last activity, such as Nov 14, 09:30.
{n} messagesHow many texts are in the thread.
→ / ← and textThe latest message, outgoing (→) or incoming (←), cut at 50 characters.
  1. Select View Conversation on a card. The dialog Conversation with {name} shows every message, yours on the right in green.
  2. Type in Reply message and select Send. You see SMS sent successfully and the thread scrolls to your reply.
  3. 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.

Table: Column, Shows
ColumnShows
(arrow)Expands the row to show recipient, alert type, channel, created, sent, delivered, read and the full message.
DateWhen the email was created.
Email AddressThe recipient.
SubjectThe subject line.
ContentThe first 80 characters.
StatusPending, Sent, Delivered, Read or Failed.
Sent AtWhen it went, or Not sent.
ActionsThe 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 a new copy

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.

Exports

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

Section 17 · Message History · 9 min
Goal: Filter and export the full notification log, report on automated alerts, and reword an alert for your workspace.

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.

The Alert Report tab with alert type, date, channel and status filters and rows of sent alert emails
Alert Report. Every automatic alert sent, by type, channel, recipient and status.
The Customize Messages tab listing alert types by group, each marked Default with a pencil to customize it
Customize Messages. Change the subject and message for any alert type; the rest keep the standard Tansi wording.
Table: Column, Shows
ColumnShows
DateWhen it was created.
TypeEmail, SMS or InApp.
Alert TypeThe automated alert that produced it, if any.
RecipientWho received it.
SubjectThe subject.
StatusThe delivery status.
DirectionAn arrow: incoming or outgoing.

Each column also has its own filter box. The grid holds the newest 500 matching messages.

The export goes further than the screen

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.

This is not the Email Templates page

Customize Messages and Email Templates store different things. Changing an alert here does not change any email template, and the other way round.

  1. Find the alert type in its category. A Default chip means standard wording; Customized shows your subject underneath.
  2. Select the pencil. The dialog Customize: {alert type} opens.
  3. Type the Subject (up to 300 characters) and the Message.
  4. 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.
  5. Read Preview with sample data under the fields.
  6. 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 sample data is only an example

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.

Custom wording is shown as plain text

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

Section 18 · Message History · 5 min
Goal: Send a single email, text or in-app notification to one person from Message History.

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.

  1. Choose the Type: Email, SMS or In-App.
  2. For In-App, search the User box (at least two characters of a name or email). In-app notifications only reach registered users.
  3. 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.
  4. Type the Subject and Message. Every field is required; Send Notification stays disabled until they are filled in.
  5. Select Send Notification. You see Notification sent successfully and the matching tab refreshes.
Table: Message, Fix
MessageFix
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.

Only an @ is checked

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.

One-off messages carry no unsubscribe link

These are operational messages. Do not use this dialog for anything promotional; that belongs in Campaigns.

Worked examples: Mass Message

Section 19 · Worked examples · 9 min
Goal: Run three realistic Mass Message sends from start to finish and avoid the traps each one sets.

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.

  1. Open Mass Communication › Mass Message.
  2. Under Projects, select Select project(s)…, search for the project and tick it. Check {n} people in scope.
  3. Under Channels, tick Email, SMS / Text and In-App Push.
  4. Under Recipients, select Add everyone in {project}.
  5. Select the No mobile chip and write down who will miss the text. Phone them.
  6. 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).
  7. On SMS, select Pull from email and trim to one segment if you can; watch the character counter.
  8. On In-App, select Pull from email for the title and body.
  9. 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.
  10. Select Send test to me and check your own phone and inbox.
  11. 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.

  1. Pick the project the warehouse belongs to under Projects.
  2. Under Recipients, search for Night shift and pick the group token.
  3. 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.
  4. Write the text, review and send.
Keep the group current

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.

  1. Pick the office project, tick Email and In-App Push, and add everyone.
  2. 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.
  3. Turn on Schedule for later and set the Date and Time (the time starts at 9:00).
  4. Select Review & Schedule, check Send time, then Schedule send.
A scheduled Mass Message cannot be canceled

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

Section 20 · Worked examples · 9 min
Goal: Set up a list with a public sign-up, import an existing customer list lawfully, send to both, and handle an unsubscribe complaint.

Example 4 — An event sign-up list on your website (events)

A conference organizer wants visitors to its website to sign up for updates.

  1. 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.
  2. 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.
  3. Turn on Ask for name if you want first and last names. Select Save changes in the bar at the bottom.
  4. 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.

  1. Save the spreadsheet as CSV with a header row.
  2. On Subscribers, filter List to the target list first — Import CSV then pre-ticks that list.
  3. Select Choose a CSV file, check that the email column Saves as Email, and read the preview counts.
  4. Tick I confirm these people agreed to receive email from us and select Import.
  5. Read the result: Import done: {n} added, {n} updated, {n} previously unsubscribed left alone, {n} invalid skipped.
Keep your own proof

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

  1. Open Campaigns and select New campaign.
  2. Pick the list under Subscriber lists (each shows its subscribed count).
  3. Compose, test and schedule as described in Module 04.

Example 7 — I unsubscribed and still got your email

  1. Ask which button they pressed. Unsubscribe from these lists only leaves the lists that campaign used; other campaigns can still reach them.
  2. Remember that opening the unsubscribe page changes nothing until a button is pressed.
  3. Check Subscribers: their status on the list should read Unsubscribed.
  4. 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.
  5. 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

Section 21 · Reference · 3 min
Goal: Find the right address for any part of Mass Communication, including the pages your subscribers see.

Pages you use

Table: Address, Name, Who can open it
AddressNameWho can open it
/safety-compliance/admin/mass-messageMass MessageDeveloper, Admin, SuperAdmin
/comms/campaignsCampaignsMass Communication access
/comms/listsListsMass Communication access
/comms/lists/{id}/shareShare & embedMass Communication access; Edit on list embeds to change it
/comms/subscribersSubscribersMass Communication access
/comms/campaign-templatesCampaign TemplatesMass Communication access
/admin/email-templatesEmail TemplatesEmail templates permission
/admin/notification-groupsNotification GroupsNotification groups permission
/admin/notificationsMessage HistoryNotifications permission
Table: Address, Name, Who can open it
AddressNameWho can open it
/comms/campaigns/{id}Campaign reportMass Communication access
/admin/notification-groups/{id}/membersManage group membersAdmin or Developer role
/admin/notification-groups/{id}/logsNotification logsNobody at present (always access denied)
/safety-compliance/admin/mass-smsRetired — opens Mass MessageAs Mass Message
/safety-compliance/admin/mass-emailRetired — opens Mass MessageAs Mass Message

Pages your subscribers see

Table: Address, Name
AddressName
/subscribe/{token}Sign-up
/subscribe/confirm/{token}Confirm your subscription
/unsubscribe/{token}Manage your email preferences
↑ Back to contentsEnd of the guide.

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.

Keyboard shortcuts

Everything in this manual works without a mouse.

Search

CtrlK
Open search from anywhere on the page
↓↑
Move down and up through the results
Enter
Go to the highlighted result and highlight every match on the page
Esc
Clear the search box and remove the highlights

Moving around

Tab
Move to the next link or button. The first stop is Skip to main content
ShiftTab
Move back to the previous link or button
Enter
Follow the focused link, or press the focused button
Space
Press the focused button, or scroll down when nothing is focused
CtrlF
Your browser’s own find, if you prefer it to the search box

This page

CtrlP
Print, or save the whole manual as a PDF
Ctrl+ −
Zoom in and out. The layout reflows down to a phone-sized window

Wide tables can be scrolled sideways with the arrow keys once you Tab onto them. Light and dark follow your system setting — the Dark / Light button overrides it for this visit.