Update the header and reconcile charges of an existing HIS inbound pre-appointment

PUT 
/v1/checkin/appointments/his-inbound/:externalAppointmentId

Updates the header fields (beneficiary, payer, doctor, specialty, agreement, service, notes, appointment date) of a pre-appointment identified by (provider from the token, external_appointment_id), and reconciles its charges against the request's charges list: charges not yet present are added, charges present in both are updated in place (quantity/provider_product_name), and charges no longer present are soft-deleted along with their documents. Only pre-appointments created by the HIS inbound integration (source HIS_INBOUND) in a non-terminal status (PENDING/CONFIRMED) can be updated. Requires valid OAuth2 authentication.

Request

Responses

200

Pre-appointment header updated and charges reconciled

400

Bad Request: the pre-appointment was not created by the HIS inbound integration (source is not HIS_INBOUND).

401

Unauthorized: missing or invalid Bearer token

403

Forbidden: your credentials are not authorised for this operation

404

Pre-appointment not found for the given external_appointment_id and provider, or provider/payer could not be found in rcm-api

409

Conflict: the pre-appointment is in a terminal status (COMPLETED or CANCELLED) and cannot be updated

422

Request validation failed. Returns validation errors with field paths and messages.

502

Bad Gateway: RCM API is unavailable or network timeout occurred.