Skip to content
English
Can't find what you are looking for? Tell us.
  • There are no suggestions because the search field is empty.

Insurance claims — how to create, validate, and export a claim

Phase 1 of the MediSprout insurance claims module lets providers and admins create insurance claims from completed visits, validate the data, and export them in CMS 1500 format (PDF or CSV) for paper submission or upload to a clearinghouse. This article walks through the full end-to-end flow. Phase 2 — submission through the Optum gateway with status tracking and remittance — is covered in a separate article when it ships.

Before you begin

  • The patient must have insurance information on file.
  • The visit must be marked as completed.
  • The provider must be configured with a valid NPI.

Step 1 — Create the claim

  1. Open the completed visit and select Generate insurance claim.
  2. Review the pre-filled fields. Borders are color-coded to show the data source — visit, patient profile, or provider configuration — so you know where to make a correction if something is wrong.
  3. Edit any field that needs updating. Validation runs continuously and any warnings or blockers appear inline (see Step 2).
  4. When the data is clean, select Create claim. A claim ID is generated and the claim moves to Draft status.

Step 2 — Understand and resolve validation messages

As you fill in the claim, MediSprout validates the data against three layers of rules. Each validation message is either a blocker (must fix before the claim can be created) or a warning (review recommended, but not required).

Layer 1 — Required fields (blockers)

Fields the CMS 1500 format requires. Examples:

  • Patient name, date of birth, sex.
  • Insurance member ID, group number, payer information.
  • Provider NPI, tax ID, billing address.
  • At least one ICD-10 diagnosis code and one CPT procedure code.

Layer 1 issues are blockers — the claim cannot be created until they are resolved.

Layer 2 — Data format (warnings)

Checks that values follow industry conventions:

  • CPT codes are valid in the current AMA code set.
  • ICD-10 codes are correctly formatted and active.
  • Billing units are within typical ranges.
  • Dates of service are not in the future.

Layer 2 issues are warnings — the claim can be created, but each warning is flagged for review.

Layer 3 — Business logic (warnings)

Checks combinations and payer-specific rules:

  • ICD-10 to CPT pairings that are non-standard.
  • Frequency limits (a code that can only be billed N times per period).
  • Payer-specific requirements (some insurers require modifiers).

Layer 3 issues are warnings. Review with your billing team — many can be acknowledged if the combination is appropriate and documented.

How to resolve a validation message

  1. Click the warning or blocker icon to jump to the affected field.
  2. Read the rule explanation in the panel that opens.
  3. Either edit the field, or select Acknowledge if the value is intentional (for example, an off-label use you've documented).
  4. Acknowledged warnings remain visible on the claim for audit purposes but do not block creation or export.

When all messages are resolved

Once every Layer 1 blocker is fixed and every Layer 2 / Layer 3 warning is either resolved or acknowledged, the claim moves to a Ready state. You can then export the claim (Step 3) or — once Phase 2 ships — submit it through the gateway.

Step 3 — Export the claim

  1. From the claim's detail view, select Export.
  2. Choose your format: CMS 1500 PDF (for printing or uploading to a clearinghouse), or CSV (for batch processing or import elsewhere).
  3. Export generation is asynchronous. You will get an in-app notification when the file is ready, typically within a minute or two.
  4. Select Download from the notification to save the file to your computer.

Finding all your claims

From the main navigation, select Insurance Claims. You can filter by status (Draft, Exported, etc.), date, patient, or provider. Click any claim to view, edit, re-validate, or export.

 

Addendum: 

Claims list

The claims list now supports additional sorting options, and CPT codes are displayed as chips rather than plain text, making them easier to scan at a glance.

Editing a claim

When you select Save on the claim edit form, the edit window now stays open if there are still unresolved validation errors, so you can address them immediately instead of having to reopen the claim. Once every blocker is resolved, saving closes the window as before.

CSV export format

The CSV export format is built specifically to be compatible with Claim MD. If your organization uses a different clearinghouse, confirm the CSV columns/format against that clearinghouse's requirements before relying on this export.

Known limitation — do not publish this section yet

The team identified an inconsistency between how Claim MD handles CMS 1500 boxes 14 and 15 and the NUCC definitions MediSprout follows. This is unresolved as of July 7, 2026 (dev is investigating / plans to contact Claim MD support). Do not add box 14/15 guidance to the published article until this is confirmed fixed — see Audit Report v10 for tracking.


Want more information? Contact MediSprout support using the chat function in the same window you are using, or call +1 866-896-1431.