Claim Proc Put Update API

[ODNovice]

Hello:
I have gone through the API spec. I have a requirement where in I need to update the claim proc from EOB. In order to perform this I would need to know how I can correlate a procedure line from the paper EOB to the claim proc that I get from the GET API call. On the paper EOB I do not of have "ProcNum" since this is OD specific field. So my question is how do I read a proc line from paper EOB and say that this correlates ProcNum say 123 on OD database?
Please let me know

[SLeon]

Good morning,

So my question is how do I read a proc line from paper EOB and say that this correlates ProcNum say 123 on OD database?

Depending on the format of the EOB, you can use the PatNum, procedure description, and service date of the line item to determine the procedure for the patient.

If I am misunderstanding your question, could you please clarify a few points in your post?

1. It sounds like you have a paper EOB in hand and want to find the Open Dental procedures listed on it, is that correct?
2. Have you entered the Claim Payment associated with the EOB into Open Dental?
3. What value(s) are you wanting to edit on a ClaimProc?

[ODNovice]

I have the paper EOB. I extracted the values using my OCR program. I want to update the insurance paid fields that I extracted into Open dental into the claim proc record for the EOB on the Opendental side.

[SLeon]

Have you entered the Claim Payment associated with the EOB into Open Dental?

[ODNovice]

Yes the dental office says they did.

[SLeon]

There are a couple ways you could go about this. The simplest is the following:

1. Use Claims GET (multiple) to find the patient's claim. You will use the PatNum parameter in this method that matches the patient indicated on your paper EOB.
2. There may be more than one result, so you can use the Claim Fee and/or various date fields to identify the one matching your EOB.
3. Use ClaimProcs GET with the ClaimNum you obtained from Step #2. These are all of the claimprocs associated with the claim.
4. Finally use ClaimProcs PUT to update the fields you mention.

[ODNovice]

Thank you. There is a claim number on the EOB, can I not query based on it? The claim number on EOB will it be different from what is there in Open Dental?

[ODNovice]

Also I have API

Code: Select all

https://api.opendental.com/api/v1/claimprocs?ProcNum=481900

This is working fine and getting the data, but when I say PUT

Code: Select all

https://api.opendental.com/api/v1/claimprocs/481900

with the following data in the body

Code: Select all

{"Status": "Received",
"InsPayAmt": "50.00"}

getting 404 claimproc not found. What am I doing wrong?

[RyanH]

Also I have API

Code: Select all

https://api.opendental.com/api/v1/claimprocs?ProcNum=481900

This is working fine and getting the data, but when I say PUT

Code: Select all

https://api.opendental.com/api/v1/claimprocs/481900

with the following data in the body

Code: Select all

{"Status": "Received",
"InsPayAmt": "50.00"}

getting 404 claimproc not found. What am I doing wrong?

Good morning ODNovice,

ProcNum is a FK to procedurelog.ProcNum, which works as a filter for claimprocs GET. If you'd like to update a claimproc through claimprocs PUT, you'll need to supply the ClaimProcNum instead of the ProcNum, which you can obtain through your GET request.

Thanks!

[ODNovice]

Thank you.
So I use ClaimProcNum to PUT data. But on the GET if I want the ClaimProc data for a particular ClaimProcNum, I do not see a GET based on this. Please see what is available. Do you know why? Jus wondering.

Code: Select all

GET /claimprocs?ProcNum=1734730
GET /claimprocs?ClaimNum=98567
GET /claimprocs?Status=Received
GET /claimprocs?PatNum=1337&ClaimPaymentNum=6352

[RyanH]

Thank you.
So I use ClaimProcNum to PUT data. But on the GET if I want the ClaimProc data for a particular ClaimProcNum, I do not see a GET based on this. Please see what is available. Do you know why? Jus wondering.

Code: Select all

GET /claimprocs?ProcNum=1734730
GET /claimprocs?ClaimNum=98567
GET /claimprocs?Status=Received
GET /claimprocs?PatNum=1337&ClaimPaymentNum=6352

Hello ODNovice,

You are correct, there currently isn't a GET single for claimprocs. Most developers supply a ClaimNum which reduces the result set significantly, and only includes the claimprocs for a given claim. I'll speak with the API team and add claimprocs GET Single to our development list.

In the meantime, to retrieve one claimproc by ClaimProcNum you can use a ShortQuery to do so.

Thanks!