Skip to main content

Invoice links, attachments, conditions, pre-authorisations and claim status

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 (.doc, .docx); Microsoft Excel (.xls, .xlsx); JPG/PNG images; Outlook (.msg) and standard email (.eml).

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

  • It 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

  1. Open the claim from Apps β†’ Insurance

  2. In the header, the Status appears as a dropdown (only for "Other" facilitators)

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

  1. Set the claim status to Settled

  2. Click the Set Settlement Amount button that appears in the header

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

  1. Go to Apps β†’ Insurance

  2. Tick the checkbox on each claim you want to update

  3. In the action bar above the table, click Change Status

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

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?

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?

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?

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?

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?

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?

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?

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.


Related Articles

Did this answer your question?