Iniciando dispensación

Con este método podrás iniciar el proceso de dispensación.

Respuesta 2xx

Este endpoint puede retornar dos diferentes códigos de respuesta de éxito:

  • 201, este código HTTP usualmente se retorna para todas las recetas y para las pre-autorizaciones donde no es necesario realizar ninguna verificación con la aseguradora.
  • 202, este código HTTP únicamente se retorna en las pre-autorizaciones donde Osigu necesita realizar una verificación con la aseguradora al momento de que se realiza la dispensación.

Código HTTP 201

NombreTipo
idnumber
ID de la dispensación.
provider_branch_namestring
Nombre de la sucursal donde se realiza la dispensación.
sponsor_transaction_idstring
Solo para las pre-autorizaciones y donde se maneje una validación con el sponsor a la hora de la dispensación, este es el ID devuelto por el Sponsor a la hora de registrar la validación.
provider_transaction_idstring
ID de la transacción de lado del proveedor, este valor se informa al finalizar la dispensación o canje de una pre-autorización.
statusstring
Estado de la pre-autorización. Los valores posibles son: IN_PROGRESS, COMPLETED, EXPIRED, VOIDED.
codestring
Código del documento dispensable (Receta o Pre-autorización).
sponsor_slugstring
Slug del sponsor que da la cobertura de la pre-autorización. En el caso de una receta este valor será nulo.
currency_codestring
Código de la moneda en que se registra la transacción, este código de moneda es según la configuración del proveedor dentro de Osigu.
amount_paid_by_patientnumber
Monto pagado por el paciente, ya sea receta o pre-autorización. En el caso de una pre-autorización es la suma de deducible, copago y coaseguro.
amount_covered_by_sponsornumber
Solo para pre-autorizaciones, es el monto cubierto por la aseguradora.
deductible_amountnumber
Solo para pre-autorizaciones, monto de deducible que de ser pagado por el paciente.
copayment_amountnumber
Solo para pre-autorizaciones, monto de copago que de ser pagado por el paciente.
coinsurance_amountnumber
Solo para pre-autorizaciones, monto de coaseguro que de ser pagado por el paciente.
productsarray[object]
Listado de productos dispensados.
invoiceobject
Información de la factura, en el caso de las recetas, esta factua es emitida al paciente y en el caso de pre-autorizaciones es la factura emitida al sponsor.

Inner Object - Products

NombreTipo
idstring
ID del item dentro del arreglo.
product_codestring
Código de SKU del proveedor
product_namestring
Nombre del producto.
substitute_product_codestring
Código de SKU del producto substituto.
substitute_product_namestring
Nombre del producto substituto.
quantitynumber
Cantidad dispensada.
currency_codestring
Código de la moneda en que se registra el precio del producto a dispensar.
pricenumber
Precio del producto con impuestos.
taxesnumber
Impuestos agregados al producto.
coinsurance_percentagenumber
Solo para pre-autorizaciones, este es el porcentaje de coaseguro que debe de cubrir el paciente.
copayment_amountnumber
Solo para pre-autorizaciones, este es el monto de copago debe de cubrir el paciente.

Inner Object - Invoice

NombreTipo
document_numberstring
Número de factura o documento fiscal equivalente emitido al Sponsor.
document_serialstring
Número de serie de factura o documento fiscal equivalente emitido al Sponsor (Para los que aplique).
document_datestring
Fecha del documento en formato ISO.
document_digital_signaturestring
Firma digital del documento (Facturas electrónicas)

Código HTTP 202

Este código solo se retornará cuando el documento a dispensar sea una pre-autorización y el Sponsor requiera que se realice una verificación con ellos en el momento de la dispensación.

NombreTipo
locationstring
URL de Tracking API en donde se podrá consultar el estado de la validación con el sponsor.

La URL de Tracking API se encontrará también en el response header llamado Location.

Language
Click Try It! to start a request and see the response here!