Procedure Logs

Test OpenDental procedure logs (treatment history, create, view, update, delete). Per OpenDental API.

What are Procedure Logs in OpenDental?

Procedure Logs are the patient's treatment history—each record is a procedure (D0120 exam, D1110 prophy, fillings, etc.) with procCode, ProcFee, ProcStatus, and optional AptNum. ProcStatus: TP (Treatment Planned), C (Complete), EO (Existing Other), EC, R, etc. Complete procedures (C) drive billing and can be attached to Claims via procNums. Procedures link to ProcedureCodes for fee schedules. Can attach to Appointments and Treatment Plans. Required before creating claims or PayPlans.

Patient Number (PatNum)

Appointment (AptNum)

Loading procedures...

ProcNum	ProcDate	procCode	Description	ProcStatus	ProcFee	ProvNum	Tooth/Surf	Actions

Enter PatNum and/or AptNum, then click "Load Procedures" to view procedures.

Create New Procedure

Required

PatNum *

ProcDate * (yyyy-MM-dd)

ProcStatus *

procCode * (e.g. D0120)

Or CodeNum. One required.

CodeNum

Appointment & Provider

AptNum

PlannedAptNum

ProvNum

ClinicNum

SiteNum

Fee, Priority, Dates

ProcFee

Discount

Priority (DefNum)

priority (string)

DateTP (yyyy-MM-dd)

ProcTime (HH:mm:ss)

ProcTimeEnd (HH:mm:ss)

Treatment Area

ToothNum

Surf

ToothRange

Diagnosis & Place of Service

Dx (DefNum, Category=16)

dxName

Use Dx or dxName, not both.

Prognosis (DefNum, Category=30)

PlaceService

Prosthesis

DateOriginalProsth

IsDateProsthEst

Notes

ClaimNote

BillingNote

Result:

Search & Update Procedure

Patient Number (PatNum)

Appointment (AptNum)

Select a procedure to update or delete:

Update Procedure

Note: CodeNum, procCode, Discount, ToothNum, Surf, ToothRange cannot be updated on Complete (C) procedures.

Procedure: -

Basic

ProcDate

ProcFee

ProcStatus

Complete (C) requires: The procedure must be attached to an appointment (AptNum) with AptStatus = Complete. If AptNum is 0, set it to a Complete appointment first, or mark the appointment as Complete in the Appointments page.

procCode

CodeNum

Discount

Appointment & Provider

AptNum

Required for ProcStatus Complete (C). That appointment must have AptStatus=Complete.

PlannedAptNum

ProvNum

ClinicNum

SiteNum

Dates & Times

DateTP

ProcTime

ProcTimeEnd

Treatment Area

ToothNum

Surf

ToothRange

Diagnosis & Place of Service

dxName

Prognosis

PlaceService

Prosthesis

DateOriginalProsth

IsDateProsthEst

Priority

priority

Notes

ClaimNote

BillingNote

Result:

Procedure Log - GET Response

GET /procedurelogs?PatNum=15. Per OpenDental API.

Example Response:

[
  {
    "ProcNum": 20,
    "PatNum": 12,
    "AptNum": 1341,
    "ProcDate": "2022-05-05",
    "ProcFee": "130.00",
    "Surf": "MODL",
    "ToothNum": "4",
    "ToothRange": "",
    "Priority": 0,
    "priority": "",
    "ProcStatus": "C",
    "ProvNum": 2,
    "provAbbr": "DOC2",
    "Dx": 0,
    "dxName": "",
    "PlannedAptNum": 0,
    "PlaceService": "Office",
    "Prosthesis": "",
    "DateOriginalProsth": "0001-01-01",
    "ClaimNote": "",
    "DateEntryC": "2022-04-17",
    "ClinicNum": 0,
    "CodeNum": 2,
    "procCode": "D0120",
    "descript": "periodic oral evaluation - established patient",
    "UnitQty": 1,
    "BaseUnits": 0,
    "DateTP": "2022-04-17",
    "SiteNum": 0,
    "HideGraphics": "false",
    "CanadianTypeCodes": "",
    "ProcTime": "00:00:00",
    "ProcTimeEnd": "00:00:00",
    "DateTStamp": "2022-05-05 07:00:34",
    "Prognosis": 0,
    "IsLocked": "false",
    "BillingNote": "",
    "Discount": 0.0,
    "IsDateProsthEst": "false",
    "SecDateEntry": "2022-04-17 09:38:21",
    "serverDateTime": "2025-06-17 09:00:34"
  }
]

All Response Fields:

ProcNum, PatNum, AptNum, ProcDate, ProcFee, Surf, ToothNum, ToothRange
Priority, priority, ProcStatus, ProvNum, provAbbr, Dx, dxName, PlannedAptNum
PlaceService, Prosthesis, DateOriginalProsth, ClaimNote, DateEntryC
ClinicNum, CodeNum, procCode, descript, UnitQty, BaseUnits, DateTP, SiteNum
HideGraphics, CanadianTypeCodes, ProcTime, ProcTimeEnd, DateTStamp
Prognosis, IsLocked, BillingNote, Discount, IsDateProsthEst, SecDateEntry, serverDateTime

Create Procedure - All Fields

POST /procedurelogs. Required: PatNum, ProcDate, ProcStatus, procCode or CodeNum. Per OpenDental API.

{
  "PatNum": 29,
  "ProcDate": "2021-04-25",
  "ProcStatus": "TP",
  "procCode": "D2331",
  "CodeNum": 33,
  "AptNum": 0,
  "PlannedAptNum": 0,
  "ProvNum": 1,
  "ClinicNum": 0,
  "SiteNum": 0,
  "ProcFee": "125.95",
  "Discount": 25.99,
  "Priority": 148,
  "priority": "Low",
  "DateTP": "2021-04-17",
  "ProcTime": "13:45:00",
  "ProcTimeEnd": "00:00:00",
  "ToothNum": "4",
  "Surf": "MO",
  "ToothRange": "",
  "Dx": 126,
  "dxName": "Cracked Tooth",
  "Prognosis": 0,
  "PlaceService": "Office",
  "Prosthesis": "",
  "DateOriginalProsth": "0001-01-01",
  "IsDateProsthEst": "false",
  "ClaimNote": "",
  "BillingNote": "Note text"
}

Use Priority or priority, not both. Use Dx or dxName, not both.

Update Procedure - All Fields

Search: GET /procedurelogs?PatNum=15. Update: PUT /procedurelogs/{ProcNum}. Per OpenDental API.

{
  "AptNum": 1023,
  "ProcDate": "2022-04-25",
  "ProcFee": "250",
  "ProcStatus": "TP",
  "ProvNum": 2,
  "Dx": 139,
  "PlannedAptNum": 0,
  "PlaceService": "PublicHealthClinic",
  "Prosthesis": "",
  "DateOriginalProsth": "0001-01-01",
  "ClaimNote": "",
  "ClinicNum": 2,
  "procCode": "D2393",
  "CodeNum": 193,
  "DateTP": "2022-04-26",
  "SiteNum": 9,
  "ProcTime": "12:10:00",
  "ProcTimeEnd": "00:00:00",
  "Prognosis": 0,
  "ToothNum": "14",
  "Surf": "MO",
  "ToothRange": "",
  "BillingNote": "",
  "Discount": 0.0,
  "IsDateProsthEst": "false",
  "Priority": 153,
  "priority": "3"
}

CodeNum, procCode, Discount, ToothNum, Surf, ToothRange cannot be updated on Complete (C) procedures.