Skip to main content

Manage Customer Documents

Add, review, switch between, delete, and restore customer ID and medical card documents on a retail customer profile, in the web app and Retail POS.

Purpose

Store a customer's ID, medical card, and supporting documents on their retail profile. The Documents card summarizes the status of every document so staff can spot an expired or missing document at a glance. Document expiration is informational. It does not block a sale.

Prerequisites

  • The user role has Update permission for Customer Profiles. Adding, editing, removing, deleting, and restoring documents all use this permission. See Creating a Customer Profile.
  • A saved customer profile. Documents are added after the profile exists.
  • Files in PNG, JPG, JPEG, or PDF format, 10 MB maximum each.

Document Types and Required Fields

Flourish requires different fields depending on the document type. A required field is marked with an asterisk in the Add Document window.

Document Type

State required

Expiration required

Driver's License

Yes

Yes

Passport

No

Yes

Permanent Resident

No

Yes

Medical Card

Yes

Yes

Veteran Documentation

No

No

SNAP Documentation

No

No

Other

No

No

State is not required for a passport or permanent resident card because they are federal documents. You can still enter State and Expiration on any document that does not require them.

Read the Documents Card

The Documents card on the customer profile starts with a summary line:

  • No documents yet
  • Document(s) expired
  • Document(s) need attention
  • All documents valid

Below the summary, each row shows the document type and the number of files. A status chip appears only when the document is not Valid or On file. Deleted documents and files are not counted in the summary, the statuses, or the POS badges.

Each document has one of these statuses:

Status

Meaning

Expired

The expiration date is before today. A document that expires today is still valid.

Expires in 30 days

The expiration date is within the next 30 days.

Valid

The expiration date is more than 30 days away.

On file

The document has no expiration date.

Add a Document

  1. Open the customer profile.
  2. On the Documents card, click Add Document.
  3. Select the Document Type.
  4. Enter the State and Expiration Date. Fields marked with an asterisk are required for that type.
  5. Add the file. Click the + icon to choose a file from your device.
  6. Click Save.

You can also click Manage on the card, then use Add document in the header or drop a file into the drop zone under the list. Both open the same window. Flourish asks for the type, state, and expiration first, then the file.

Past expiration dates: If you enter a date in the past, Flourish shows an Expiration Date is a past date warning but still lets you save. This lets you record a document that has already expired.

Review or Edit a Document

  1. On the Documents card, click Manage.
  2. Review the list. Each row shows the Document (type, file name, and page count), State, Expires, and Status.
  3. Click a row to open the document.
  4. Update the type, state, or expiration date, or add or remove files. PDF files preview inline.
  5. Click Save.
  6. Click All documents to return to the list.

The document window shows all of a customer's documents, so you can review an ID and a medical card, front and back, without leaving the window. This works the same in the web app and in Retail POS, whether you open the window from the customer profile or from a badge in Intake > Search Customers.

Switch documents

  • Click a document chip at the top of the window. Each chip shows the document type and expiration date, for example Driver's License · exp 10/31/28. An expired document's chip shows in red.
  • Or click the ‹ and › arrows next to the Document 1 of 2 title.

The whole window switches to the selected document, including its type, state, expiration date, and images. This also works when a customer has two documents of the same type, such as two driver's licenses.

Switch images within a document

  • Click the ‹ and › arrows on the image or PDF preview. The Image 1 of 2 indicator shows where you are.
  • Or press the left and right arrow keys on your keyboard. This works when your cursor isn't in a form field.
  • You can still click a file name in the file list to jump to it.

Document 1 of 2

Document 2 of 2

Unsaved changes: If you edited the type, state, or expiration date and then switch to another document, Flourish asks whether to Save or Discard your changes first.

Remove a File From a Document

Use this when a photo is wrong or unreadable but the document record should stay.

  1. Open the document from Manage, or from a badge in Retail POS.
  2. Select the file, then click Remove file. In Retail POS, click the ✕ on the image, next to the rotate buttons.
  3. Confirm the removal. Flourish always asks first and reminds you that the file can be restored. [VERIFY: confirmation wording, e.g. "Remove this image? You can restore it from Deleted documents."]

Delete a Document

Delete a document to remove it and all of its files from the customer's active documents.

  1. On the Documents card, click the trash icon on the document's row. Or open the document from Manage and click Delete document in the lower left.
  2. Confirm the deletion.
Record retention: Deleting a document or file never removes it permanently. Flourish keeps it for audit purposes, and you can restore it yourself. See Restore a Deleted Document or File.

Restore a Deleted Document or File

  1. Open the customer profile.
  2. On the Documents card, turn on Show deleted to see the Deleted section.
  3. Review the list. Each deleted document or file shows who deleted it and the date, in the facility's time zone.
  4. Click Restore on the item.

The restored document or file is active again. It reappears in the document list and counts toward the card summary, statuses, and POS badges.

Cancel an Upload

Click Cancel while adding a document. Flourish asks you to confirm. If you confirm, the document and everything you entered are discarded and nothing is added to the profile.

In Retail POS, Intake > Search Customers shows each customer's State ID number and expiration date, plus a document badge:

  • DL covers Driver's License, Passport, and Permanent Resident documents.
  • MED covers Medical Card documents.

An expired date shows in red. Veteran Documentation, SNAP Documentation, and Other do not show a badge, because they are not identity documents. Deleted documents don't show a badge.

Click a badge to open the document window. It opens on the matching document, and the customer's other documents are one click away in the document chips. See Move Between Documents and Images and Checking In a Customer.

Tip: If you just updated a document and the list still shows the old status, search for the customer again to refresh the result.

Troubleshooting

If you see

Do this

The Save button won't enable

Check the required fields for the document type in the table above.

You can't delete, restore, or remove a file

Ask an administrator to turn on Update permission for Customer Profiles in your user role.

A customer shows no DL badge after you added their passport or ID

Search for the customer again. If it still shows none on file, confirm the document type is Driver's License, Passport, or Permanent Resident, and that the document wasn't deleted.

You deleted a document or file by mistake

Restore it from the Deleted section of the Documents card. See Restore a Deleted Document or File.

You can only see one of the customer's documents in the window

Click the other document's chip at the top of the window, or use the arrows next to the Document 1 of 2 title.

How did we do?

Adding a Physician