# Enter a charge

Canonical page: https://docs.ovok.com/api/patient-billing/enter-a-charge

`POST /v1/patient-billing/patients/{patientId}/charges`

Enters a charge: one billable service a clinic gave the patient, as a FHIR `ChargeItem`. It goes on the account the clinic keeps for the patient, which Ovok makes with the first charge and which names the patient's coverages in order.

**Scope:** the caller's project, with `PATIENT_BILLING_ENABLED` on.

## Behaviour

- Your access policy must grant `patient_billing_charges` `create` and let you read the patient, else **403** `PATIENT_BILLING_NOT_ALLOWED` or **404** `PATIENT_BILLING_PATIENT_NOT_FOUND`.
- `clinicId` must be a clinic (Organization) the patient is enrolled with, else **422** `BILLING_CLINIC_INVALID`.
- The unit price comes from the price list, as it applies on the day of `occurredAt`; without one, **422** `CHARGE_PRICE_MISSING`. `priceOverride` sets the unit price instead and needs an `overrideReason`.
- The charge keeps its unit price, so later price changes leave it alone. `total` is the unit price times `quantity`.
- `identifier` is optional. With it, the same identifier for the same patient again answers the charge already entered, with **200**. A new charge answers **201** with `Location: /v1/patient-billing/charges/<id>`.

## Example

```bash
curl -X POST 'https://api.sandbox.ovok.com/v1/patient-billing/patients/<patientId>/charges' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjcyNjg4MDAsImV4cCI6MTc2NzI3MjQwMH0.Ql3B_ztDvctlyZ2z0vp4sl3ExXRQGkzmxdmTAqxNzZk' \
  -H 'Content-Type: application/json' \
  -d '{ "clinicId": "<clinicId>", "code": { "system": "http://fhir.de/CodeSystem/kbv/ebm", "code": "03040", "display": null }, "occurredAt": "2026-11-18", "quantity": 1 }'
```
