Seguros — BestDoctorsRD API

POST/v1/coverage-estimates

Estimate ARS coverage and patient balance

Parámetros

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

Cuerpo obligatorio `CoverageEstimateCreateIn`

Campo	Tipo	Obl.
`patientId`	string	Sí
`serviceCode`	string	Sí
`sourceModule`	string	No
`insurancePlanId`	string o nulo	No
`quantity`	number	No
`branchId`	string o nulo	No
`admissionId`	string o nulo	No
`previousEstimateId`	string o nulo	No
`auditReason`	string o nulo	No

Respuestas

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

GET/v1/insurance-authorizations

List insurance authorizations

Parámetros

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

Respuestas

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

POST/v1/insurance-authorizations

Create an insurance authorization request

Parámetros

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

Cuerpo obligatorio `InsuranceAuthorizationCreateIn`

Campo	Tipo	Obl.
`patientId`	string	Sí
`insurancePlanId`	string	Sí
`serviceCode`	string	Sí
`description`	string	Sí
`requestedAmount`	number	Sí
`admissionId`	string o nulo	No

Respuestas

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

curl

curl -X POST "https://api.bestdoctorsrd.com/v1/insurance-authorizations" \
  -H "Content-Type: application/json" \
  -d '{ "patientId": …, "insurancePlanId": …, "serviceCode": …, "description": … }'

PATCH/v1/insurance-authorizations/{authorization_id}

Update insurance authorization status

Parámetros

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

Cuerpo obligatorio `InsuranceAuthorizationUpdateIn`

Campo	Tipo	Obl.
`status`	"APPROVED" \| "REJECTED" \| "EXPIRED"	Sí
`authNumber`	string o nulo	No
`approvedAmount`	number o nulo	No

Respuestas

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

GET/v1/insurance-claim-remittances

List ARS remittances with matched lines

Parámetros

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

Respuestas

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

POST/v1/insurance-claim-remittances

Import an ARS remittance and match lines to submitted claims

Parámetros

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

Cuerpo obligatorio `InsuranceClaimRemittanceCreateIn`

Campo	Tipo	Obl.
`remittanceNumber`	string	Sí
`insurancePlanId`	string	Sí
`receivedAt`	string (date-time) o nulo	No
`lines`	lista de RemittanceLineIn	Sí

Respuestas

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

curl

curl -X POST "https://api.bestdoctorsrd.com/v1/insurance-claim-remittances" \
  -H "Content-Type: application/json" \
  -d '{ "remittanceNumber": …, "insurancePlanId": …, "lines": … }'

PATCH/v1/insurance-claim-remittances/{remittance_id}/lines/{line_id}/appeal

Appeal a glosa line with evidence attachments

Parámetros

Nombre	En	Tipo	Obl.
`remittance_id`	path	string	Sí
`line_id`	path	string	Sí

Cuerpo obligatorio `RemittanceLineAppealIn`

Campo	Tipo	Obl.
`appealEvidence`	lista de string	Sí
`note`	string o nulo	No

Respuestas

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

curl

curl -X PATCH "https://api.bestdoctorsrd.com/v1/insurance-claim-remittances/{remittance_id}/lines/{line_id}/appeal" \
  -H "Content-Type: application/json" \
  -d '{ "appealEvidence": … }'

POST/v1/insurance-claim-remittances/{remittance_id}/post-settlement

Post remittance settlement to claims and invoice balances

Parámetros

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

Respuestas

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

GET/v1/insurance-claims

List insurance claims

Parámetros

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

Respuestas

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

POST/v1/insurance-claims

Create an insurance claim

Parámetros

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

Cuerpo obligatorio `InsuranceClaimCreateIn`

Campo	Tipo	Obl.
`invoiceId`	string	Sí
`insurancePlanId`	string	Sí
`claimAmount`	number	Sí
`claimNumber`	string o nulo	No
`patientId`	string o nulo	No

Respuestas

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

GET/v1/insurance-claims/reconciliation-kpis

Return ARS receivables, glosa and recovery KPIs

Parámetros

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

Respuestas

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

PATCH/v1/insurance-claims/{claim_id}

Advance insurance claim lifecycle

Parámetros

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

Cuerpo obligatorio `InsuranceClaimUpdateIn`

Campo	Tipo	Obl.
`status`	"DRAFT" \| "SUBMITTED" \| "PROCESSING" \| "APPROVED" \| "REJECTED" \| "RESUBMITTED" \| "PAID"	Sí
`settlementAmount`	number o nulo	No

Respuestas

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

Estimate ARS coverage and patient balance

Parámetros

Cuerpo obligatorio CoverageEstimateCreateIn

Respuestas

List insurance authorizations

Parámetros

Respuestas

Create an insurance authorization request

Parámetros

Cuerpo obligatorio InsuranceAuthorizationCreateIn

Respuestas

Update insurance authorization status

Parámetros

Cuerpo obligatorio InsuranceAuthorizationUpdateIn

Respuestas

List ARS remittances with matched lines

Parámetros

Respuestas

Import an ARS remittance and match lines to submitted claims

Parámetros

Cuerpo obligatorio InsuranceClaimRemittanceCreateIn

Respuestas

Appeal a glosa line with evidence attachments

Parámetros

Cuerpo obligatorio RemittanceLineAppealIn

Respuestas

Post remittance settlement to claims and invoice balances

Parámetros

Respuestas

List insurance claims

Parámetros

Respuestas

Create an insurance claim

Parámetros

Cuerpo obligatorio InsuranceClaimCreateIn

Respuestas

Return ARS receivables, glosa and recovery KPIs

Parámetros

Respuestas

Advance insurance claim lifecycle

Parámetros

Cuerpo obligatorio InsuranceClaimUpdateIn

Respuestas

Cuerpo obligatorio `CoverageEstimateCreateIn`

Cuerpo obligatorio `InsuranceAuthorizationCreateIn`

Cuerpo obligatorio `InsuranceAuthorizationUpdateIn`

Cuerpo obligatorio `InsuranceClaimRemittanceCreateIn`

Cuerpo obligatorio `RemittanceLineAppealIn`

Cuerpo obligatorio `InsuranceClaimCreateIn`

Cuerpo obligatorio `InsuranceClaimUpdateIn`