API Adjustments

See API Specification

Adjustments GET

Version Added: 22.2

Gets all adjustments assigned to a specific patient.

PatNum: Required in the URL.
AdjType: (Added in version 22.2.33) Optional. definition.DefNum where definition.Category=1.

Example Requests:
GET /adjustments?PatNum=26
GET /adjustments?PatNum=42&AdjType=2

Example Response:
[
{
"AdjNum": 1,
"AdjDate": "2022-07-02",
"AdjAmt": -25.0,
"PatNum": 26,
"AdjType": 1,
"adjType": "Misc Neg Adjustment",
"ProvNum": 1,
"AdjNote": "Cash Discount",
"ProcDate": "2022-07-02",
"ProcNum": 0,
"ClinicNum": 0
},
{
"AdjNum": 2,
"AdjDate": "2022-07-18",
"AdjAmt": 50.0,
"PatNum": 26,
"AdjType": 2,
"adjType": "Misc Pos Adjustment",
"ProvNum": 1,
"AdjNote": "Finance Charge",
"ProcDate": "2022-07-18",
"ProcNum": 0,
"ClinicNum": 0
}
etc...
]

200 OK
400 BadRequest (with explanation)
404 NotFound (with explanation)

Adjustments POST (create)

Version Added: 22.2

Creates a new adjustment for a patient. The following fields cannot be set as part of a POST: AdjNum and adjType.

PatNum: Required.
AdjType: Required. Definition.DefNum where definition.Category=1, and definition.ItemValue="+" or "-".
AdjAmt: Required. Must be positive if the passed in AdjType has an ItemValue of "+", or negative if the passed in AdjType has an ItemValue of "-".
AdjDate: Required. The date that the adjustment will show in the patient's account. Cannot be a future date. String in "yyyy-MM-dd" format.
ProvNum: Optional. Will default to the ProvNum of the patient's primary provider.
ProcNum: Optional. Only used if attaching this adjustment to a procedure. The patient attached to the procedure must match the passed in PatNum. Default 0.
ClinicNum: Optional. Will default to the ClinicNum of the patient's clinic.
ProcDate: Optional. The date of the procedure. String in "yyyy-MM-dd" format. If attaching to a procedure then this will default to the ProcDate of the procedure. Specify a ProcDate to override the procedure's date. If not attached to a procedure, this will default to today's date.
AdjNote: Optional. Note for the adjustment.

Example Request:
POST /adjustments

{
"PatNum": 15,
"AdjType": 1,
"AdjAmt": -24.99,
"AdjDate": "2022-07-19",
"ProvNum": 1,
"AdjNote": "Discount",
"ProcNum": 18,
"ProcDate": "2022-06-10",
"ClinicNum": 1
}

Example Response:
{
"AdjNum": 12,
"AdjDate": "2022-07-19",
"AdjAmt": -24.99,
"PatNum": 15,
"AdjType": 1,
"adjType": "Misc Neg Adjustment",
"ProvNum": 1,
"AdjNote": "Discount",
"ProcDate": "2022-06-10",
"ProcNum": 18,
"ClinicNum": 1
}

201 Created
400 Bad Request (with explanation)
404 NotFound (with explanation)

Adjustments PUT (update)

Version Added: 22.2

Updates an adjustment. The following fields cannot be updated as part of a PUT: AdjNum, PatNum, ProcDate. A discount plan adjustment cannot be changed to another AdjType.

AdjNum: Required in the URL.

AdjDate: The date that the adjustment will show in the patient's account. Cannot be a future date. String in "yyyy-MM-dd" format.
AdjAmt: Must be positive if the AdjType of the adjustment is positive, or negative if the AdjType is negative or a discount plan.
AdjType: Definition.DefNum where definition.Category=1, and definition.ItemValue="+" or "-". Must be positive if the adjustment is positive, or negative if the adjustment is negative. Can be passed alongside AdjAmt to change the adjustment from positive to negative, and vice versa.
ProvNum: ProvNum of a provider.
AdjNote: Note for the adjustment.
ProcNum: Attaches the adjustment to a procedure, overwriting any previous ProcNum. The procedure's patient must match the patient on the adjustment. Updating this value will also update the adjustment's ProcDate to match the newly attached procedure's ProcDate.
ClinicNum: ClinicNum of a clinic.

Example Requests:
PUT /adjustments/17

{
"AdjAmt": -24.49
}

{
"AdjDate": "2022-07-21",
"AdjAmt": 39.50,
"AdjType": 2,
"ProvNum": 4,
"AdjNote": "Additional Charge",
"ProcNum": 22,
"ClinicNum": 0
}

Example Response:
{
"AdjNum": 17,
"AdjDate": "2022-07-21",
"AdjAmt": 39.5,
"PatNum": 21,
"AdjType": 2,
"adjType": "Misc Pos Adjustment",
"ProvNum": 4,
"AdjNote": "Additional Charge",
"ProcDate": "2022-05-25",
"ProcNum": 22,
"ClinicNum": 0
}

200 OK
400 Bad Request (with explanation)
404 NotFound (with explanation)