Facturación — BestDoctorsRD API

GET/v1/billing/admissions

List Billing Admissions

Parámetros

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

Respuestas

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

GET/v1/billing/admissions/{admission_id}

Get Billing Admission

Parámetros

Nombre	En	Tipo	Obl.
`admission_id`	path	string	Sí
`tenantId`	query	string o nulo	No

Respuestas

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

GET/v1/billing/charges

List Legacy Billing Charges

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	objeto

POST/v1/billing/charges

Create Legacy Billing Charge

Respuestas

Código	Descripción	Devuelve
201	Respuesta correcta	objeto

GET/v1/billing/patients

List Billing Patients

Parámetros

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

Respuestas

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

GET/v1/billing/unbilled-visits

List Unbilled Visits

Visitas atendidas sin NINGÚN cargo ligado — la worklist que cierra la fuga "atendido sin facturar". Cubre dos tipos: (1) encuentros ambulatorios COMPLETED sin cargo por encounter ni por su cita, y (2) internamientos DISCHARGED (dados de alta) sin cargo por admisión. Al completar/dar de alta no se crea cargo, así que una atendida-nunca-facturada no aparece en /charges (no hay fila) y, una vez pasa el día, se pierde. Read-only, sin efectos secundarios; ventana en días y tenant-scoped.

Parámetros

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

Respuestas

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

GET/v1/invoice-ncf-sequences

List Invoice Ncf Sequences

Parámetros

Nombre	En	Tipo	Obl.
`branchId`	query	string o nulo	No
`ncfType`	query	string o nulo	No
`active`	query	boolean o nulo	No
`tenantId`	query	string o nulo	No

Respuestas

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

POST/v1/invoice-ncf-sequences

Create Invoice Ncf Sequence

Parámetros

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

Cuerpo obligatorio `InvoiceNcfSequenceCreateIn`

Campo	Tipo	Obl.
`branchId`	string o nulo	No
`ncfType`	string	Sí
`prefix`	string	Sí
`rangeStart`	integer	Sí
`rangeEnd`	integer	Sí
`expiresAt`	string (date-time) o nulo	No
`isActive`	boolean	No

Respuestas

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

GET/v1/invoices

List Invoices

Parámetros

Nombre	En	Tipo	Obl.
`patientId`	query	string o nulo	No
`status`	query	string o nulo	No
`ncfType`	query	string o nulo	No
`fromDate`	query	string (date-time) o nulo	No
`toDate`	query	string (date-time) o nulo	No
`includePaidDate`	query	boolean	No
`search`	query	string o nulo	No
`tenantId`	query	string o nulo	No

Respuestas

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

POST/v1/invoices

Create Invoice

Parámetros

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

Cuerpo obligatorio `InvoiceCreateIn`

Campo	Tipo	Obl.
`patientId`	string	Sí
`chargeIds`	lista de string	No
`items`	lista de PatientChargeCreateIn	No
`ncfType`	string o nulo	No
`ncfNumber`	string o nulo	No
`paymentMethod`	string o nulo	No

Respuestas

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

GET/v1/invoices/{invoice_id}

Get Invoice

Parámetros

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

Respuestas

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

PATCH/v1/invoices/{invoice_id}

Update Invoice

Parámetros

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

Cuerpo obligatorio `InvoiceUpdateIn`

Campo	Tipo	Obl.
`ncfType`	string o nulo	No
`ncfNumber`	string o nulo	No
`paymentMethod`	string o nulo	No

Respuestas

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

GET/v1/invoices/{invoice_id}/credit-notes

List Invoice Credit Notes

Parámetros

Nombre	En	Tipo	Obl.
`invoice_id`	path	string	Sí
`tenantId`	query	string o nulo	No

Respuestas

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

POST/v1/invoices/{invoice_id}/credit-notes

Emitir nota de credito (B04) o debito (B03) contra una factura

Parámetros

Nombre	En	Tipo	Obl.
`invoice_id`	path	string	Sí
`tenantId`	query	string o nulo	No

Cuerpo obligatorio `CreditNoteIn`

Campo	Tipo	Obl.
`noteType`	"CREDIT" \| "DEBIT"	Sí
`amount`	number	Sí
`reason`	string	Sí

Respuestas

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

PATCH/v1/invoices/{invoice_id}/status

Update Invoice Status

Parámetros

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

Cuerpo obligatorio `InvoiceStatusIn`

Campo	Tipo	Obl.
`status`	"PAID" \| "VOIDED"	Sí
`voidReason`	string o nulo	No

Respuestas

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

GET/v1/patient-charges

List Patient Charges

Parámetros

Nombre	En	Tipo	Obl.
`admissionId`	query	string o nulo	No
`patientId`	query	string o nulo	No
`doctorId`	query	string o nulo	No
`status`	query	string o nulo	No
`sourceModule`	query	string o nulo	No
`area`	query	string o nulo	No
`encounterId`	query	string o nulo	No
`appointmentId`	query	string o nulo	No
`fromDate`	query	string (date-time) o nulo	No
`toDate`	query	string (date-time) o nulo	No
`tenantId`	query	string o nulo	No

Respuestas

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

POST/v1/patient-charges

Create Patient Charge

Parámetros

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

Cuerpo obligatorio `PatientChargeCreateIn`

Campo	Tipo	Obl.
`patientId`	string	Sí
`branchId`	string o nulo	No
`doctorId`	string o nulo	No
`admissionId`	string o nulo	No
`appointmentId`	string o nulo	No
`encounterId`	string o nulo	No
`clinicalRecordId`	string o nulo	No
`invoiceId`	string o nulo	No
`area`	string o nulo	No
`sourceModule`	string	Sí
`originEntityType`	string o nulo	No
`originEntityId`	string o nulo	No
`originEventId`	string o nulo	No
`idempotencyKey`	string o nulo	No
`serviceCode`	string	Sí
`description`	string	No
`currency`	string	No
`quantity`	number	Sí
`unitPrice`	number	No
`discount`	number	No
`insuranceCover`	number	No
`insurancePlanId`	string o nulo	No
`coverageEstimateId`	string o nulo	No

Respuestas

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

curl

curl -X POST "https://api.bestdoctorsrd.com/v1/patient-charges" \
  -H "Content-Type: application/json" \
  -d '{ "patientId": …, "sourceModule": …, "serviceCode": …, "quantity": … }'

GET/v1/patient-charges/{charge_id}/audit

Get Patient Charge Audit

Parámetros

Nombre	En	Tipo	Obl.
`charge_id`	path	string	Sí
`tenantId`	query	string o nulo	No

Respuestas

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

PATCH/v1/patient-charges/{charge_id}/status

Update Patient Charge Status

Parámetros

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

Cuerpo obligatorio `PatientChargeStatusIn`

Campo	Tipo	Obl.
`status`	"INSURANCE_COVERED" \| "PAID" \| "VOIDED"	Sí
`auditReason`	string o nulo	No

Respuestas

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

List Billing Admissions

Parámetros

Respuestas

Get Billing Admission

Parámetros

Respuestas

List Legacy Billing Charges

Respuestas

Create Legacy Billing Charge

Respuestas

List Billing Patients

Parámetros

Respuestas

List Unbilled Visits

Parámetros

Respuestas

List Invoice Ncf Sequences

Parámetros

Respuestas

Create Invoice Ncf Sequence

Parámetros

Cuerpo obligatorio InvoiceNcfSequenceCreateIn

Respuestas

List Invoices

Parámetros

Respuestas

Create Invoice

Parámetros

Cuerpo obligatorio InvoiceCreateIn

Respuestas

Get Invoice

Parámetros

Respuestas

Update Invoice

Parámetros

Cuerpo obligatorio InvoiceUpdateIn

Respuestas

List Invoice Credit Notes

Parámetros

Respuestas

Emitir nota de credito (B04) o debito (B03) contra una factura

Parámetros

Cuerpo obligatorio CreditNoteIn

Respuestas

Update Invoice Status

Parámetros

Cuerpo obligatorio InvoiceStatusIn

Respuestas

List Patient Charges

Parámetros

Respuestas

Create Patient Charge

Parámetros

Cuerpo obligatorio PatientChargeCreateIn

Respuestas

Get Patient Charge Audit

Parámetros

Respuestas

Update Patient Charge Status

Parámetros

Cuerpo obligatorio PatientChargeStatusIn

Respuestas

Cuerpo obligatorio `InvoiceNcfSequenceCreateIn`

Cuerpo obligatorio `InvoiceCreateIn`

Cuerpo obligatorio `InvoiceUpdateIn`

Cuerpo obligatorio `CreditNoteIn`

Cuerpo obligatorio `InvoiceStatusIn`

Cuerpo obligatorio `PatientChargeCreateIn`

Cuerpo obligatorio `PatientChargeStatusIn`