Emergencias — BestDoctorsRD API

GET/v1/emergency/encounters

List Emergency Encounters

Parámetros

Nombre	En	Tipo	Obl.
`tenantId`	query	string o nulo	No
`status`	query	string o nulo	No
`branchId`	query	string o nulo	No
`area`	query	string o nulo	No
`responsibleUserId`	query	string o nulo	No
`includeInactive`	query	boolean	No
`boardView`	query	boolean	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	lista de EmergencyEncounterOut
422	Error de validación	HTTPValidationError

POST/v1/emergency/encounters

Create Emergency Encounter

Parámetros

Nombre	En	Tipo	Obl.
`tenantId`	query	string o nulo	No

Cuerpo obligatorio `EmergencyEncounterCreateIn`

Campo	Tipo	Obl.
`patientId`	string o nulo	No
`newPatient`	QuickPatientIn o nulo	No
`temporaryPatient`	TemporaryPatientIn o nulo	No
`branchId`	string o nulo	No
`arrivalMode`	string	No
`arrivedAt`	string (date-time) o nulo	No
`chiefComplaint`	string	Sí
`acuity`	integer o nulo	No
`vitals`	object o nulo	No
`forceDuplicateReview`	boolean	No

Respuestas

Código	Descripción	Devuelve
201	Respuesta correcta	EmergencyEncounterOut
422	Error de validación	HTTPValidationError

POST/v1/emergency/encounters/{encounter_id}/admission-request

Request Admission From Emergency

Parámetros

Nombre	En	Tipo	Obl.
`encounter_id`	path	string	Sí

Cuerpo obligatorio `EmergencyAdmissionRequestIn`

Campo	Tipo	Obl.
`attendingDoctorId`	string	Sí
`bedId`	string o nulo	No
`admissionType`	string	No
`diagnosis`	string	No
`diagnosisIcd10`	string o nulo	No
`reason`	string o nulo	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	objeto
422	Error de validación	HTTPValidationError

POST/v1/emergency/encounters/{encounter_id}/conversion-retry

Retry Emergency Conversion

Parámetros

Nombre	En	Tipo	Obl.
`encounter_id`	path	string	Sí

Cuerpo obligatorio `EmergencyConversionIn`

Campo	Tipo	Obl.
`attendingDoctorId`	string	Sí
`bedId`	string o nulo	No
`admissionType`	string	No
`diagnosis`	string	No
`diagnosisIcd10`	string o nulo	No
`reason`	string o nulo	No
`requestedBedType`	string o nulo	No
`forceNewAdmission`	boolean	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	EmergencyConversionOut
422	Error de validación	HTTPValidationError

GET/v1/emergency/encounters/{encounter_id}/conversion-status

Get Emergency Conversion Status

Parámetros

Nombre	En	Tipo	Obl.
`encounter_id`	path	string	Sí

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	EmergencyConversionOut
422	Error de validación	HTTPValidationError

POST/v1/emergency/encounters/{encounter_id}/convert-to-admission

Convert Emergency To Admission

Parámetros

Nombre	En	Tipo	Obl.
`encounter_id`	path	string	Sí

Cuerpo obligatorio `EmergencyConversionIn`

Campo	Tipo	Obl.
`attendingDoctorId`	string	Sí
`bedId`	string o nulo	No
`admissionType`	string	No
`diagnosis`	string	No
`diagnosisIcd10`	string o nulo	No
`reason`	string o nulo	No
`requestedBedType`	string o nulo	No
`forceNewAdmission`	boolean	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	EmergencyConversionOut
422	Error de validación	HTTPValidationError

POST/v1/emergency/encounters/{encounter_id}/cubicle-assignment

Assign Observation Cubicle

Parámetros

Nombre	En	Tipo	Obl.
`encounter_id`	path	string	Sí

Cuerpo obligatorio `CubicleAssignmentIn`

Campo	Tipo	Obl.
`cubicleId`	string	Sí

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	ObservationCubicleOut
422	Error de validación	HTTPValidationError

POST/v1/emergency/encounters/{encounter_id}/cubicle-release

Release Observation Cubicle

Parámetros

Nombre	En	Tipo	Obl.
`encounter_id`	path	string	Sí

Cuerpo opcional `CubicleReleaseIn o nulo`

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	ObservationCubicleOut
422	Error de validación	HTTPValidationError

POST/v1/emergency/encounters/{encounter_id}/medication-administrations

Create Emergency Medication Administration

Parámetros

Nombre	En	Tipo	Obl.
`encounter_id`	path	string	Sí

Cuerpo obligatorio `EmergencyMedicationAdministrationCreateIn`

Campo	Tipo	Obl.
`cpoeOrderId`	string o nulo	No
`prescriptionItemId`	string o nulo	No
`inventoryProductId`	string o nulo	No
`medicationName`	string	Sí
`dose`	string	Sí
`route`	string o nulo	No
`quantity`	number	No
`administeredAt`	string (date-time) o nulo	No
`lotNumber`	string o nulo	No
`result`	"ADMINISTERED" \| "HELD" \| "REFUSED" \| "WASTED" \| "MISSED"	No
`notes`	string o nulo	No
`createCharge`	boolean	No

Respuestas

Código	Descripción	Devuelve
201	Respuesta correcta	EmergencyMedicationAdministrationOut
422	Error de validación	HTTPValidationError

curl

curl -X POST "https://api.bestdoctorsrd.com/v1/emergency/encounters/{encounter_id}/medication-administrations" \
  -H "Content-Type: application/json" \
  -d '{ "medicationName": …, "dose": … }'

PATCH/v1/emergency/encounters/{encounter_id}/merge-review

Flag Emergency Merge Review

Parámetros

Nombre	En	Tipo	Obl.
`encounter_id`	path	string	Sí

Cuerpo obligatorio `EmergencyMergeReviewIn`

Campo	Tipo	Obl.
`candidatePatientId`	string	Sí
`reason`	string	Sí

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	EmergencyEncounterOut
422	Error de validación	HTTPValidationError

curl

curl -X PATCH "https://api.bestdoctorsrd.com/v1/emergency/encounters/{encounter_id}/merge-review" \
  -H "Content-Type: application/json" \
  -d '{ "candidatePatientId": …, "reason": … }'

POST/v1/emergency/encounters/{encounter_id}/orders

Create Emergency Encounter Order

Parámetros

Nombre	En	Tipo	Obl.
`encounter_id`	path	string	Sí

Cuerpo obligatorio `EmergencyEncounterOrderCreateIn`

Campo	Tipo	Obl.
`orderingProviderId`	string o nulo	No
`orderType`	"MEDICATION" \| "LAB" \| "IMAGING" \| "PROCEDURE" \| "NURSING"	Sí
`destination`	"PHARMACY" \| "LAB" \| "IMAGING" \| "PROCEDURE" \| "NURSING"	Sí
`priority`	string	No
`diagnosisCode`	string o nulo	No
`diagnosisText`	string o nulo	No
`reason`	string	Sí
`instructions`	string o nulo	No
`items`	lista de CpoeOrderItemIn	Sí
`controlledWorkflowConfirmed`	boolean	No

Respuestas

Código	Descripción	Devuelve
201	Respuesta correcta	object
422	Error de validación	HTTPValidationError

curl

curl -X POST "https://api.bestdoctorsrd.com/v1/emergency/encounters/{encounter_id}/orders" \
  -H "Content-Type: application/json" \
  -d '{ "orderType": …, "destination": …, "reason": …, "items": … }'

PATCH/v1/emergency/encounters/{encounter_id}/status

Update Emergency Status

Parámetros

Nombre	En	Tipo	Obl.
`encounter_id`	path	string	Sí

Cuerpo obligatorio `EmergencyStatusUpdateIn`

Campo	Tipo	Obl.
`status`	string	Sí
`disposition`	string o nulo	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	EmergencyEncounterOut
422	Error de validación	HTTPValidationError

POST/v1/emergency/encounters/{encounter_id}/supplies

Create Emergency Supply Consumption

Parámetros

Nombre	En	Tipo	Obl.
`encounter_id`	path	string	Sí

Cuerpo obligatorio `EmergencySupplyConsumptionCreateIn`

Campo	Tipo	Obl.
`procedureName`	string	No
`procedureCode`	string o nulo	No
`performedAt`	string (date-time) o nulo	No
`result`	"COMPLETED" \| "PARTIAL" \| "CANCELLED" \| "DEFERRED"	No
`supplies`	lista de EmergencySupplyLineIn	Sí
`notes`	string o nulo	No
`createCharge`	boolean	No

Respuestas

Código	Descripción	Devuelve
201	Respuesta correcta	EmergencySupplyRecordOut
422	Error de validación	HTTPValidationError

POST/v1/emergency/encounters/{encounter_id}/transfer-charges

Transfer Emergency Charges

PRD-36 / US-6: transfiere los cargos de emergencia a la cuenta de la admisión resultante. Idempotente: un cargo ya transferido (con admissionId) nunca se transfiere dos veces; preserva origen, sello de tiempo, actor y la referencia del encuentro (campos origin_* del cargo).

Parámetros

Nombre	En	Tipo	Obl.
`encounter_id`	path	string	Sí

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	ChargeTransferResultOut
422	Error de validación	HTTPValidationError

PATCH/v1/emergency/encounters/{encounter_id}/triage

Update Emergency Triage

Parámetros

Nombre	En	Tipo	Obl.
`encounter_id`	path	string	Sí

Cuerpo obligatorio `EmergencyTriageUpdateIn`

Campo	Tipo	Obl.
`acuity`	integer	Sí
`chiefComplaint`	string o nulo	No
`triageNotes`	string o nulo	No
`painScore`	integer o nulo	No
`arrivalMode`	string o nulo	No
`arrivedAt`	string (date-time) o nulo	No
`vitals`	object o nulo	No
`status`	string	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	EmergencyEncounterOut
422	Error de validación	HTTPValidationError

GET/v1/emergency/encounters/{encounter_id}/workspace

Get Emergency Encounter Workspace

Parámetros

Nombre	En	Tipo	Obl.
`encounter_id`	path	string	Sí

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	EmergencyEncounterWorkspaceOut
422	Error de validación	HTTPValidationError

GET/v1/emergency/observation-cubicles

List Observation Cubicles

Parámetros

Nombre	En	Tipo	Obl.
`tenantId`	query	string o nulo	No
`branchId`	query	string o nulo	No
`status`	query	string o nulo	No
`resourceType`	query	string o nulo	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	lista de ObservationCubicleOut
422	Error de validación	HTTPValidationError

POST/v1/emergency/observation-cubicles

Create Observation Cubicle

Parámetros

Nombre	En	Tipo	Obl.
`tenantId`	query	string o nulo	No

Cuerpo obligatorio `ObservationCubicleCreateIn`

Campo	Tipo	Obl.
`branchId`	string	Sí
`resourceType`	string	No
`area`	string	No
`label`	string	Sí
`status`	string	No
`blockedReason`	string o nulo	No

Respuestas

Código	Descripción	Devuelve
201	Respuesta correcta	ObservationCubicleOut
422	Error de validación	HTTPValidationError

PATCH/v1/emergency/observation-cubicles/{cubicle_id}

Update Observation Cubicle

Parámetros

Nombre	En	Tipo	Obl.
`cubicle_id`	path	string	Sí

Cuerpo obligatorio `ObservationCubicleUpdateIn`

Campo	Tipo	Obl.
`resourceType`	string o nulo	No
`area`	string o nulo	No
`label`	string o nulo	No
`status`	string o nulo	No
`blockedReason`	string o nulo	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	ObservationCubicleOut
422	Error de validación	HTTPValidationError

GET/v1/emergency/resource-history

List Emergency Resource History

Parámetros

Nombre	En	Tipo	Obl.
`tenantId`	query	string o nulo	No
`branchId`	query	string o nulo	No
`encounterId`	query	string o nulo	No
`resourceId`	query	string o nulo	No
`patientId`	query	string o nulo	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	lista de EmergencyResourceHistoryOut
422	Error de validación	HTTPValidationError

List Emergency Encounters

Parámetros

Respuestas

Create Emergency Encounter

Parámetros

Cuerpo obligatorio EmergencyEncounterCreateIn

Respuestas

Request Admission From Emergency

Parámetros

Cuerpo obligatorio EmergencyAdmissionRequestIn

Respuestas

Retry Emergency Conversion

Parámetros

Cuerpo obligatorio EmergencyConversionIn

Respuestas

Get Emergency Conversion Status

Parámetros

Respuestas

Convert Emergency To Admission

Parámetros

Cuerpo obligatorio EmergencyConversionIn

Respuestas

Assign Observation Cubicle

Parámetros

Cuerpo obligatorio CubicleAssignmentIn

Respuestas

Release Observation Cubicle

Parámetros

Cuerpo opcional CubicleReleaseIn o nulo

Respuestas

Create Emergency Medication Administration

Parámetros

Cuerpo obligatorio EmergencyMedicationAdministrationCreateIn

Respuestas

Flag Emergency Merge Review

Parámetros

Cuerpo obligatorio EmergencyMergeReviewIn

Respuestas

Create Emergency Encounter Order

Parámetros

Cuerpo obligatorio EmergencyEncounterOrderCreateIn

Respuestas

Update Emergency Status

Parámetros

Cuerpo obligatorio EmergencyStatusUpdateIn

Respuestas

Create Emergency Supply Consumption

Parámetros

Cuerpo obligatorio EmergencySupplyConsumptionCreateIn

Respuestas

Transfer Emergency Charges

Parámetros

Respuestas

Update Emergency Triage

Parámetros

Cuerpo obligatorio EmergencyTriageUpdateIn

Respuestas

Get Emergency Encounter Workspace

Parámetros

Respuestas

List Observation Cubicles

Parámetros

Respuestas

Create Observation Cubicle

Parámetros

Cuerpo obligatorio ObservationCubicleCreateIn

Respuestas

Update Observation Cubicle

Parámetros

Cuerpo obligatorio ObservationCubicleUpdateIn

Respuestas

List Emergency Resource History

Parámetros

Respuestas

Cuerpo obligatorio `EmergencyEncounterCreateIn`

Cuerpo obligatorio `EmergencyAdmissionRequestIn`

Cuerpo obligatorio `EmergencyConversionIn`

Cuerpo obligatorio `EmergencyConversionIn`

Cuerpo obligatorio `CubicleAssignmentIn`

Cuerpo opcional `CubicleReleaseIn o nulo`

Cuerpo obligatorio `EmergencyMedicationAdministrationCreateIn`

Cuerpo obligatorio `EmergencyMergeReviewIn`

Cuerpo obligatorio `EmergencyEncounterOrderCreateIn`

Cuerpo obligatorio `EmergencyStatusUpdateIn`

Cuerpo obligatorio `EmergencySupplyConsumptionCreateIn`

Cuerpo obligatorio `EmergencyTriageUpdateIn`

Cuerpo obligatorio `ObservationCubicleCreateIn`

Cuerpo obligatorio `ObservationCubicleUpdateIn`