When submitting a claim it is key to ensure all the supporting information is present. Entering the condition the insurer needs to assess, linking the invoice items that make up the financial total, attaching the supporting documents the insurer expects, and β for non-integrated insurers β keep the claim status up to date as the insurer processes it. Pre-authorisations follow the same shape but link estimate items instead of completed invoices. Getting these five things right is what determines whether a claim settles cleanly or comes back with queries.
π‘ In short: On the Condition step, record the diagnosis and treatment dates and tick the invoice items that relate to it. On Attachments, add a Pet Timeline PDF, files from the pet record, or files from your computer. For "Other" claims, update the status and settlement amount as the insurer responds. Pre-authorisations work the same way but search estimate items rather than completed invoices.
Filling the Condition Step
The Condition step describes the medical reason for the claim. It's required for every claim and pre-auth β the wizard won't let you submit until every required field is green.
Field | What to enter |
Diagnosis (Select or type) * | The medical condition. Type to search the code list and pick a result, or type a free-text description if no code matches. Once you select a coded diagnosis, the Condition Code field below auto-populates. |
Condition Code | The standard insurer code. VENOM codes for VetEnvoy and "Other" insurers; Vetsure-specific codes for Vetsure. Auto-fills when you pick a diagnosis from the list. |
Claim Started On | The first date the pet was seen for this condition. Used by insurers to determine whether the condition predates the policy. Not shown on Vetsure or pre-auth claims. |
Claim Treatment Date From * | The earliest treatment date included in this claim. Lupa filters the invoice search to this date range, so set it accurately. |
Claim Treatment Date To * | The latest treatment date in this claim. Must be on or after the From date β Lupa shows "Treatment end date must be after or equal to the start date" if not. |
Claim Continuation | Tick if this is continued treatment for a condition you've already claimed. Reveals a Claim Reference Number field where you enter the previous claim's reference. |
Death or Euthanasia | Tick if the claim relates to end-of-life. Hidden for Vetsure claims (which use a separate Vetsure-specific flow). |
Additional Information | Free-text notes for the insurer. Vetsure only, max 1,000 characters. Use this for clinical context that doesn't fit elsewhere. |
π‘ Vetsure shows the policy period inline. A purple "Policy Period Coverage" panel appears under the date pickers showing the policy start and end dates. If your treatment dates fall outside coverage, Lupa blocks submission with: "It does not appear that cover was in place at the time of treatment. Please contact the Vetsure Team for assistance."
Linking Invoice Items
The bottom half of the Condition step is where you tick the invoice line items that make up the claim's financial total.
Step 1: Open the Invoice Search
Click Add Invoice in the Invoice Items section. Lupa shows a search filtered to the claim's treatment date range and to the right invoice status:
Standard claims β only Completed invoices are shown
Pre-authorisations β only Estimate invoices are shown If nothing matches, you'll see "There are no completed invoices within the selected treatment period" (or "...estimates within the selected treatment period" for pre-auths). Adjust the treatment dates or check that the invoice has been completed before linking. Once you click on an invoice or estimate, you will have the chance to add more or simply close the dialogue to proceed.
Step 2: Select the Line Items
Each matching invoice expands to show its line items β every product and service billed. Tick the items that relate to the claimed condition, leave the unrelated ones unticked. Each item shows:
Column | What it shows |
Description | The product or service name as it appears on the invoice |
Type | Product or Service |
Amount ex-VAT | Item price before tax |
VAT | Tax amount |
Invoice number | Which invoice the item belongs to |
Date | The invoice date |
A claim can include items from multiple invoices β common for ongoing conditions where treatment spans several visits (initial consult, X-ray, surgery, post-op checks). Open each invoice in turn and tick what's relevant.
π One claim per item. Items already linked to a different active claim are flagged "Attached to a different claim" and cannot be selected. They become available again only if the existing claim is moved to Declined or Nullified.
Step 3: Review the Totals
As you tick items, Lupa recalculates three totals automatically (rounded to two decimal places):
Total | What it shows |
Total ex-VAT | Sum of all linked items before tax |
VAT | Sum of all linked items' tax amounts |
Total inc-VAT | Combined total β this is what's claimed |
β οΈ At least one item is required. The Condition step won't tick green and the Submit Claim button stays disabled until at least one invoice (or estimate) item is linked. Lupa shows "Please add at least one invoice item" on claims, "Please add at least one estimate item" on pre-auths.
Adding Attachments
The Attachments step is the last step of the wizard and the most flexible β it accepts three sources of files in three stacked sections, in this order: Pet Timeline, Pet Record, and Your Computer.
File Type and Size Limits
Limit | Detail |
Maximum file size | 10 MB per file. Larger files are rejected with a size-limit error. |
Allowed file types (Vetsure only) | PDF; Microsoft Word ( |
Allowed file types (VetEnvoy and Other) | Any file type, up to the same 10 MB limit. Vetsure's stricter list is the practical floor for cross-insurer compatibility. |
Pet Timeline / History (Auto-Generated PDF)
Click Attach Pet Timeline to generate a PDF of the pet's full clinical history and attach it in one click. This is the easiest way to give the insurer the patient's complete record without exporting and re-uploading manually.
The PDF is named
{pet name}-claim-pet-timeline.pdfIt includes every timeline item type except reminders
Financial details are included by default
The button disables once the timeline is attached, with the message "Pet timeline already added" β you can only have one timeline attachment per claim
π The Attach Pet Timeline button is hidden if the claim has been submitted, settled, declined, or nullified. The timeline is also auto-deleted if the claim is not submitted within 15 minutes β start the wizard, attach, and submit in one sitting where possible.
From the Pet Record
The Attach from Pet Record section lists files already saved to the pet's profile (lab reports, imaging, scanned letters). Tick the ones you need and click Add Selected to copy them into the claim.
For Vetsure claims, only files matching the allowed type list appear β others are filtered out automatically
Duplicate filenames are blocked, so you can't add the same file twice
If the section is empty, you'll see "No documents found on pet record"
From Your Computer
The bottom section is a standard file picker β drag and drop, or click to browse. Multiple files at once is fine. For Vetsure claims, the picker shows a hint: "The file must be under 5 MB. Accepted formats: Microsoft Word and Excel documents, JPG/PNG images, PDF documents, MSG/EML email files." The actual size cap is 10 MB; treat 5 MB as the practical guideline if your insurer's email gateway is strict.
Upload Status
Each attachment carries a status that tells you where it is in the pipeline.
Status | Meaning |
Pending | Saved to the claim, not yet sent to the insurer. Will be uploaded automatically when the claim moves to Initiated, Ready for Processing, or Processing. |
Uploaded to Insurer | Sent to the insurer's system successfully (Vetsure or VetEnvoy). |
Declined | Cannot be uploaded β the claim is closed (Settled, Declined, or Nullified). Lupa shows "Attachments cannot be uploaded because this claim has been settled or declined." |
If you are recording the claim details to submit through an external provider portal, you can download the claim form and pet timeline from this dialogue.
π‘ Vetsure auto-attaches a Claim Details PDF on submission. Even if you skip Attachments, Vetsure receives a generated summary so the assessor sees a complete claim. The Pet Timeline and your own files are added to that.
Pre-Authorisations vs. Claims
Pre Authorisation is currently only available for Vetsure insurance policies. A pre-auth is the same wizard you'd use for a claim, but with three operational differences. Use a pre-auth before high-value treatment to confirm the insurer will cover it; use a claim after treatment to be reimbursed for what was done.
Difference | Standard claim | Pre-authorisation |
Linked items source | Completed invoices only | Estimates only |
Treatment Date From | Editable β set to the start of treatment | Locked to today (Vetsure) β pre-auths cover future treatment |
Treatment Date To | Required, editable | Auto-set to end-of-day on the From date β hidden in the form |
Date validation | Must fall inside the policy period | Must be today or later (a pre-auth for past treatment makes no sense) |
Continuation field label | Claim Continuation | Pre-auth Continuation |
Empty-search message | "There are no completed invoices within the selected treatment period" | "There are no estimates within the selected treatment period" |
At least one item required | Invoice item | Estimate item |
Once a pre-auth is approved and treatment goes ahead, you don't reuse the pre-auth β you create a new standard claim against the completed invoice and reference the pre-auth in Claim Continuation if the insurer asks.
Updating Claim Status
Status updates only apply to "Other" (non-integrated) claims. For Vetsure and VetEnvoy claims, status flows in automatically as the insurer's system processes them. For "Other" claims β anything you submit by post, email, or the insurer's own portal β Lupa is just your record-keeping system. You're responsible for keeping the status current.
Updating One Claim
Open the claim from Apps β Insurance
In the header, the Status appears as a dropdown (only for "Other" facilitators)
Pick the new status β the change saves immediately and a confirmation toast shows "Claim status updated successfully"
π Reverting a submitted claim to Draft or Initiated to edit invoice items, attachments, or condition details requires the Update Submitted Claims permission. Without it, the dropdown only allows forward transitions.
Recording the Settlement Amount
When the insurer settles a claim β usually for less than the claimed amount because of excess and policy caps β record what they actually paid:
Set the claim status to Settled
Click the Set Settlement Amount button that appears in the header
Enter the amount in the Set Settlement Amount dialog and click Confirm The settled amount then displays in the claim header and in the Settlement Amount column on the claims list. This figure is what you reconcile against the insurer's remittance, not the original claim total.
Bulk Status Updates
For bulk updates β for example, marking a batch of submitted claims as Settled when an insurer pays a monthly run β use the claims list:
Go to Apps β Insurance
Tick the checkbox on each claim you want to update
In the action bar above the table, click Change Status
Pick the new status and confirm
β οΈ Integrated claims are skipped automatically. If your selection includes Vetsure or VetEnvoy claims, Lupa shows "{count} integrated claims won't be affected" and only updates the "Other" claims. Bulk updates can never override the integrated insurer's automatic status.
The Change Status button is greyed out if every selected claim is integrated, or if the bulk update is currently running.
Tips
β Best practices from practices that run Lupa:
Set treatment dates carefully β they filter the invoice search. A one-day overlap is a common reason an invoice "isn't there"
Pick the diagnosis from the list, not free-text β only coded diagnoses populate the Condition Code, which most insurers require
Always add the Pet Timeline
For Vetsure claims, also upload the invoice itself as an attachment β Vetsure expects an invoice document alongside the linked items
For "Other" claims, log status updates the day they happen β the Days in Status counter is your stalled-claim alarm
Use bulk status changes at month-end β selecting all submitted "Other" claims that have been paid in a single remittance and setting them to Settled in one go is much faster than opening each
For high-value treatment, pre-auth first β five minutes upfront beats six weeks of dispute
Troubleshooting
Problem | Solution |
No invoices appear in the search | Three things to check: (1) the treatment dates on the Condition step cover the invoice date, (2) the invoice is Completed for a claim or an Estimate for a pre-auth, and (3) the invoice belongs to the same store as the claim. |
"Attached to a different claim" on a line item | That item is already linked elsewhere. Find the other claim (the claims list shows linked invoice numbers), and either remove the item there, or move that claim to Nullified if it's no longer needed. Items unlink automatically when a claim moves to Declined or Nullified. |
Condition step has a green tick but Submit is still disabled | For Vetsure, the policy must be Live (or Cancelled during a renewal transition) and have a Vetsure insurance group set. The Submit button reveals the specific reason on hover. |
"Treatment end date must be after or equal to the start date" | Treatment Date To is earlier than From. Edit either date and the green tick returns. |
"It does not appear that cover was in place at the time of treatment" (Vetsure) | Treatment dates fall outside the policy period shown in the purple panel. Either correct the dates, or contact Vetsure if you believe the policy was active. |
Attachment rejected with "exceeds size limit" | The file is over 10 MB. Compress the PDF or split it into two files. For scanned documents, set the scanner to a lower DPI (300 dpi is plenty for insurer evidence). |
"Pet timeline already added" β can't attach again | Only one Pet Timeline PDF per claim. If the existing timeline is out of date, remove it from the attachment list first, then click Attach Pet Timeline again. |
Attachments stuck on Pending | Pending uploads are sent when the claim is in Initiated, Ready for Processing, or Processing. If the claim is still Draft, submit it. If the claim has moved to Settled or Declined, no further uploads happen β Lupa shows "Attachments cannot be uploaded because this claim has been settled or declined." |
Set Settlement Amount button is missing | The button only appears when the claim status is Settled. Set the status first, then enter the amount. |
Change Status is greyed out on the claims list | Every selected claim is a Vetsure or VetEnvoy claim β bulk status updates only apply to "Other" claims. Filter the list by Facilitator: Other and reselect. |
Status dropdown is missing on the claim detail page | The claim is submitted to Vetsure or VetEnvoy. Status flows back from the insurer automatically; manual updates aren't supported. To edit the claim itself, the Update Submitted Claims permission is required. |
Frequently Asked Questions
Can I change linked invoice items after the claim is submitted?
Can I change linked invoice items after the claim is submitted?
No. Invoice items are locked once the claim is submitted. To edit them, the claim status would need to be reverted to Draft or Initiated, which requires the Update Submitted Claims permission. Items don't unlink unless the claim moves to Declined or Nullified.
What happens to the linked items if I nullify or decline the claim?
What happens to the linked items if I nullify or decline the claim?
They become available again. When a claim moves to Nullified or Declined, Lupa releases each linked item β they show as unattached on the original invoice and can be linked to a different claim if needed.
Do I need to attach anything for Lupa to let me submit?
Do I need to attach anything for Lupa to let me submit?
No β Attachments is the only optional step in the wizard. The four required steps (Policy, Pet, Condition, Clinician) all have to be green, but Attachments doesn't block submission. Most claims still benefit from a Pet Timeline and the relevant invoice document.
Can I attach a video or large imaging file?
Can I attach a video or large imaging file?
Only if it's under 10 MB. Insurers don't accept very large files via the standard upload β for an MRI, X-ray series, or video, share via the insurer's portal or a download link in the Additional Information field, and attach a small reference image (under 10 MB) to the claim.
Can a single claim include items from invoices at different stores?
Can a single claim include items from invoices at different stores?
No. Each claim belongs to a single store, and the invoice search is filtered to that store. If the pet was treated at multiple sites, you'll need a separate claim per store, or transfer the relevant invoices into a single store before linking.
The settlement amount is less than the claim total β is that a problem?
The settlement amount is less than the claim total β is that a problem?
No, it's normal. Insurers deduct the policyholder's excess, apply policy caps, and sometimes decline specific items. The Settlement Amount field stores what the insurer actually paid; the original claim total is preserved separately for audit.
Why can't I change the status on a Vetsure or VetEnvoy claim?
Why can't I change the status on a Vetsure or VetEnvoy claim?
Integrated claims update automatically β Vetsure and VetEnvoy push status changes back into Lupa as the claim progresses through their systems. Manual edits would conflict with the insurer's record. The dropdown is hidden for these claims and bulk status updates skip them.
Can I convert a pre-authorisation into a claim once treatment is done?
Can I convert a pre-authorisation into a claim once treatment is done?
Not directly β the pre-auth and the claim are separate records. Once treatment is complete and the invoice is finalised, create a new claim against the completed invoice. If the insurer issued a pre-auth reference number, tick Claim Continuation on the new claim and enter it in Claim Reference Number so they can match the two.
