Recetas — BestDoctorsRD API

GET/v1/patients/{patient_id}/prescriptions

List Patient Prescriptions

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Respuestas

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

GET/v1/pharmacy/prescriptions

List Pharmacy Prescriptions

Parámetros

Nombre	En	Tipo	Obl.
`search`	query	string o nulo	No
`status`	query	string o nulo	No
`tenant_id`	query	string o nulo	No

Respuestas

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

GET/v1/pharmacy/reports/dispensing

Pharmacy Dispensing Report

Parámetros

Nombre	En	Tipo	Obl.
`fromDate`	query	string (date) o nulo	No
`toDate`	query	string (date) o nulo	No
`patientId`	query	string o nulo	No
`doctorId`	query	string o nulo	No
`medicationName`	query	string o nulo	No
`insuranceName`	query	string o nulo	No
`lotNumber`	query	string o nulo	No
`movementType`	query	string o nulo	No
`expirationStatus`	query	string o nulo	No
`controlledOnly`	query	boolean	No
`includeReturns`	query	boolean	No
`tenant_id`	query	string o nulo	No

Respuestas

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

POST/v1/prescriptions

Create Prescription

Parámetros

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

Cuerpo obligatorio `PrescriptionCreateIn`

Campo	Tipo	Obl.
`patientId`	string	Sí
`doctorId`	string o nulo	No
`appointmentId`	string o nulo	No
`encounterId`	string o nulo	No
`pharmacyName`	string o nulo	No
`items`	lista de PrescriptionItemIn	Sí
`controlledWorkflowConfirmed`	boolean	No
`safetyOverrideConfirmed`	boolean	No
`safetyOverrideReason`	string o nulo	No

Respuestas

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

GET/v1/prescriptions/refill-reminder-hooks

List Refill Reminder Hooks

Parámetros

Nombre	En	Tipo	Obl.
`daysAhead`	query	integer	No
`tenant_id`	query	string o nulo	No

Respuestas

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

POST/v1/prescriptions/safety-check

Check Prescription Safety

Preview the blocking allergy/duplicate-therapy checklist before prescribing. Read-only — lets the prescriber surface conflicts in the UI without creating a prescription. ``blocking`` is true when any conflict would stop POST /v1/prescriptions unless explicitly overridden.

Parámetros

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

Cuerpo obligatorio `PrescriptionSafetyCheckIn`

Campo	Tipo	Obl.
`patientId`	string	Sí
`medicationNames`	lista de string	Sí

Respuestas

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

GET/v1/prescriptions/validate/{validation_code}

Validate Prescription

Parámetros

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

Respuestas

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

GET/v1/prescriptions/{prescription_id}

Get Prescription

Parámetros

Nombre	En	Tipo	Obl.
`prescription_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Respuestas

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

POST/v1/prescriptions/{prescription_id}/dispense

Dispense Prescription

Parámetros

Nombre	En	Tipo	Obl.
`prescription_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `PrescriptionDispenseIn`

Campo	Tipo	Obl.
`items`	lista de DispenseItemIn	Sí
`controlledConfirmed`	boolean	No
`factors`	DispenseFactorsIn o nulo	No

Respuestas

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

POST/v1/prescriptions/{prescription_id}/dispense/{dispense_movement_id}/reverse

Reverse Dispense Prescription

Parámetros

Nombre	En	Tipo	Obl.
`prescription_id`	path	string	Sí
`dispense_movement_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `PrescriptionDispenseReverseIn`

Campo	Tipo	Obl.
`reason`	string	Sí

Respuestas

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

POST/v1/prescriptions/{prescription_id}/finalize

Finalize Prescription

Parámetros

Nombre	En	Tipo	Obl.
`prescription_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo opcional `FinalizePrescriptionIn o nulo`

Respuestas

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

POST/v1/prescriptions/{prescription_id}/items/{prescription_item_id}/refill

Record Prescription Item Refill

Parámetros

Nombre	En	Tipo	Obl.
`prescription_id`	path	string	Sí
`prescription_item_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Respuestas

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

POST/v1/prescriptions/{prescription_id}/items/{prescription_item_id}/return

Return Prescription Item

Parámetros

Nombre	En	Tipo	Obl.
`prescription_id`	path	string	Sí
`prescription_item_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `PrescriptionReturnIn`

Campo	Tipo	Obl.
`productId`	string	Sí
`quantity`	number	Sí
`reason`	string	Sí
`authorizationCode`	string o nulo	No
`controlledConfirmed`	boolean	No

Respuestas

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

curl

curl -X POST "https://api.bestdoctorsrd.com/v1/prescriptions/{prescription_id}/items/{prescription_item_id}/return" \
  -H "Content-Type: application/json" \
  -d '{ "productId": …, "quantity": …, "reason": … }'

POST/v1/prescriptions/{prescription_id}/items/{prescription_item_id}/substitute

Substitute Prescription Item

Parámetros

Nombre	En	Tipo	Obl.
`prescription_id`	path	string	Sí
`prescription_item_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `PrescriptionSubstitutionIn`

Campo	Tipo	Obl.
`fromProductId`	string	Sí
`toProductId`	string	Sí
`quantity`	number	Sí
`reason`	string	Sí
`authorizationCode`	string	Sí
`controlledConfirmed`	boolean	No

Respuestas

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

curl

curl -X POST "https://api.bestdoctorsrd.com/v1/prescriptions/{prescription_id}/items/{prescription_item_id}/substitute" \
  -H "Content-Type: application/json" \
  -d '{ "fromProductId": …, "toProductId": …, "quantity": …, "reason": … }'

GET/v1/prescriptions/{prescription_id}/refill-eligibility

Get Refill Eligibility

Parámetros

Nombre	En	Tipo	Obl.
`prescription_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Respuestas

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

PATCH/v1/prescriptions/{prescription_id}/status

Update Prescription Status

Parámetros

Nombre	En	Tipo	Obl.
`prescription_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `PrescriptionStatusIn`

Campo	Tipo	Obl.
`status`	string	Sí

Respuestas

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

GET/v1/reception/analytics

Reception Analytics

Agregados para el Tablero (farmacia): KPIs + series por día / estado / riesgo / hora.

Parámetros

Nombre	En	Tipo	Obl.
`days`	query	integer	No

Respuestas

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

GET/v1/reception/audit

Reception Audit

Parámetros

Nombre	En	Tipo	Obl.
`limit`	query	integer	No

Respuestas

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

POST/v1/reception/claim

Reception Claim

Cuerpo obligatorio `ReceptionClaimIn`

Campo	Tipo	Obl.
`validationCode`	string	Sí

Respuestas

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

GET/v1/reception/history

Reception History

Parámetros

Nombre	En	Tipo	Obl.
`limit`	query	integer	No

Respuestas

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

POST/v1/reception/orders/{prescription_id}/complete

Reception Complete

Parámetros

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

Cuerpo obligatorio `ReceptionCompleteIn`

Campo	Tipo	Obl.
`factors`	DispenseFactorsIn o nulo	No

Respuestas

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

POST/v1/reception/orders/{prescription_id}/reject

Reception Reject

Parámetros

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

Cuerpo obligatorio `ReceptionRejectIn`

Campo	Tipo	Obl.
`reason`	string	Sí

Respuestas

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

POST/v1/reception/otp/send

Reception Otp Send

Cuerpo obligatorio `ReceptionOtpSendIn`

Campo	Tipo	Obl.
`prescriptionId`	string	Sí

Respuestas

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

GET/v1/reception/queue

Reception Queue

Parámetros

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

Respuestas

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

GET/v1/reception/report

Reception Report

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	objeto

GET/v1/reception/stats

Reception Stats

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	objeto

List Patient Prescriptions

Parámetros

Respuestas

List Pharmacy Prescriptions

Parámetros

Respuestas

Pharmacy Dispensing Report

Parámetros

Respuestas

Create Prescription

Parámetros

Cuerpo obligatorio PrescriptionCreateIn

Respuestas

List Refill Reminder Hooks

Parámetros

Respuestas

Check Prescription Safety

Parámetros

Cuerpo obligatorio PrescriptionSafetyCheckIn

Respuestas

Validate Prescription

Parámetros

Respuestas

Get Prescription

Parámetros

Respuestas

Dispense Prescription

Parámetros

Cuerpo obligatorio PrescriptionDispenseIn

Respuestas

Reverse Dispense Prescription

Parámetros

Cuerpo obligatorio PrescriptionDispenseReverseIn

Respuestas

Finalize Prescription

Parámetros

Cuerpo opcional FinalizePrescriptionIn o nulo

Respuestas

Record Prescription Item Refill

Parámetros

Respuestas

Return Prescription Item

Parámetros

Cuerpo obligatorio PrescriptionReturnIn

Respuestas

Substitute Prescription Item

Parámetros

Cuerpo obligatorio PrescriptionSubstitutionIn

Respuestas

Get Refill Eligibility

Parámetros

Respuestas

Update Prescription Status

Parámetros

Cuerpo obligatorio PrescriptionStatusIn

Respuestas

Reception Analytics

Parámetros

Respuestas

Reception Audit

Parámetros

Respuestas

Reception Claim

Cuerpo obligatorio ReceptionClaimIn

Respuestas

Reception History

Parámetros

Respuestas

Reception Complete

Parámetros

Cuerpo obligatorio ReceptionCompleteIn

Respuestas

Reception Reject

Parámetros

Cuerpo obligatorio ReceptionRejectIn

Respuestas

Reception Otp Send

Cuerpo obligatorio ReceptionOtpSendIn

Respuestas

Reception Queue

Cuerpo obligatorio `PrescriptionCreateIn`

Cuerpo obligatorio `PrescriptionSafetyCheckIn`

Cuerpo obligatorio `PrescriptionDispenseIn`

Cuerpo obligatorio `PrescriptionDispenseReverseIn`

Cuerpo opcional `FinalizePrescriptionIn o nulo`

Cuerpo obligatorio `PrescriptionReturnIn`

Cuerpo obligatorio `PrescriptionSubstitutionIn`

Cuerpo obligatorio `PrescriptionStatusIn`

Cuerpo obligatorio `ReceptionClaimIn`

Cuerpo obligatorio `ReceptionCompleteIn`

Cuerpo obligatorio `ReceptionRejectIn`

Cuerpo obligatorio `ReceptionOtpSendIn`