Insurance carriers, plans and benefits
Set up the US carriers and plans the practice bills, and keep each plan's benefit design so estimates and claims cite the right figures.
These pages are for practices in the United States. A practice in another country does not see them, and the API refuses insurance requests from one.
Insurance lives in three settings pages, all under Insurance in the settings hub and visible to roles with the insurance permission at a US practice.
Carriers
Settings → Insurance carriers lists the payers. Each carrier carries its payer id (for electronic claims), an NEA payer id when it accepts electronic attachments, its address and phone, and two switches: whether it accepts electronic attachments and whether it answers eligibility checks. Archive a carrier the practice no longer bills; its plans stay readable.
The payer id is what a claim names the carrier by, and it is also what a secondary or tertiary claim tells the next payer about the payers before it: a coordinated claim carries the prior payer's id exactly as it stood on the claim Smileline sent that payer. Keep it as the clearinghouse lists it.
Plans
Settings → Insurance plans holds the employer and group plans under each carrier. A plan names its carrier, plan type (PPO, HMO, indemnity, discount or Medicaid), employer, group name and number, and its renewal month for a plan whose benefit year does not follow the calendar. Point Allowed amounts at a fee schedule to record the carrier's allowed fees; estimates then use the lower of the practice fee and that allowed amount.
Benefits
Settings → Insurance benefits keeps each plan's benefit design as effective-dated revisions.
Choose the plan, then click New revision.
Enter the CDT edition the design is written against, the dates it is in force, the coverage kind (percentage or copay), and the deductibles and maximums in dollars. Blank means the plan has none.
Add one row per CDT range: the codes it covers, the category, the percentage covered, which deductible applies and the network.
Add exceptions for single codes: excluded, downgraded to another code's rate, an age limit, a frequency limit, a waiting period or a coverage override. Add copays per code or per category for a copay plan.
If this revision corrects a live one, choose it under Retire a live revision this one replaces. Save.
A revision is written once. Nothing on it can be edited afterwards, because every estimate stamps the revision it was made under. A correction is a new revision that retires the mistaken one; retired revisions stay listed.
Two live revisions of one plan can never cover the same day, and two ranges of one revision can never overlap within a network; the page refuses both with a clear message.
Claims billing identity
At the top of Settings → Insurance benefits, click Edit under Claims billing identity and enter the practice's type-2 NPI, its tax id (EIN) and its taxonomy code (122300000X for a general dental practice). Every claim's billing provider loop carries them; sending refuses until the NPI and tax id are on file. The card also says whether this cell has a clearinghouse connection.
Clearinghouse connection
Claims travel through Stedi. Support sets the cell's Stedi API key,
submitter id and usage indicator, and configures a Stedi webhook for
processed transactions pointing at /webhooks/stedi with the cell's shared
secret as the Authorization header. While any of these is missing, the
billing identity card says so, Send on a claim refuses, and the desk
records outcomes by hand.
Card readers
Buy a Stripe Terminal reader, set it up and register it, see whether it is online, and understand how a card-present payment reaches the patient ledger.
NHS contracts, targets and rates
Record the practice's NHS England contracts, each contract year's UDA and UOA targets, the performers on each contract, and read the band rates in force.