Skip to main content

CreateExternallyProcessedAuthorizationRequest

Register an authorization that was generated outside OSIGU so it becomes visible to downstream flows (claim, dispensation, settlement).

beneficiary_idinteger<int64>required

Beneficiary identifier. Long integer returned by the beneficiary search.

sponsor_authorization_codestring

Authorization code assigned by the sponsor.

provider_slugsstring[]

Providers allowed to redeem the authorization.

payment_typestring

Payment type. One of DIRECT_PAYMENT or REIMBURSEMENT.

How the authorization is paid.

  • DIRECT_PAYMENT: the sponsor pays the provider directly.
  • REIMBURSEMENT: the beneficiary pays out-of-pocket and requests reimbursement from the sponsor.

Possible values: [DIRECT_PAYMENT, REIMBURSEMENT]

doctor_medical_license_numberstringrequired

Prescribing doctor's medical license number.

doctor_country_codestringrequired

ISO 3166-1 alpha-2 code of the country that issued the doctor's license.

doctor_specialty_namestring

Prescribing doctor's medical specialty.

doctor_namestringrequired

Prescribing doctor's full name.

diagnoses object[]required

Diagnoses associated with the authorization.

  • Array [
    • coding_systemstringrequired

    Coding system used for the diagnosis (for example, ICD-10, CIE-10).

    codestringrequired

    Diagnosis code within the coding system.

    typestring

    Diagnosis type as a free-form string.

    type_enumstring

    Diagnosis type. One of CHIEF_COMPLAINT, DIFFERENTIAL_DIAGNOSIS, MEDICAL_DIAGNOSIS.

    Role of the diagnosis in the encounter.

    • CHIEF_COMPLAINT: the primary reason the beneficiary sought care.
    • DIFFERENTIAL_DIAGNOSIS: an alternative diagnosis being considered.
    • MEDICAL_DIAGNOSIS: the confirmed medical diagnosis.

    Possible values: [CHIEF_COMPLAINT, DIFFERENTIAL_DIAGNOSIS, MEDICAL_DIAGNOSIS]

  • ]
    • products object[]required

    Products included in the authorization.

  • Array [
    • product_idinteger<int64>required

    OSIGU product identifier.

    actionstring

    Update action to apply to this line. Values include ADD, REMOVE, UPDATE.

    provider_slugstring

    Slug of the provider that will dispense this product.

    provider_product_codestring

    Provider-side SKU or code for this product.

    authorized_quantityinteger<int32>

    Number of units the sponsor has authorized.

    statusstring

    Line status after the update (for example, APPROVED, REJECTED).

    reasonstring

    Free-text explanation of the current status.

  • ]
    • coverage_typestring

    Insurance coverage type.

    Possible values: [OUTPATIENT_CARE, PRESCRIPTION_DRUGS, DIAGNOSTIC_TESTS, EDUCATION, SPORTS, WELLNESS, CREDIT_CARD_BALANCE, PERMANENT_DISABILITY, UNEMPLOYMENT, FUNERAL_ASSISTANCE, PPI, TEMPORARY_DISABILITY, MEDICAL_PROCEDURES, SECOND_ASSESSMENT, CANCER_DIAGNOSIS, DAILY_HOSPITALIZATION_INCOME, ACCIDENT_MEDICAL_REIMBURSEMENT, DIABETES_ACCIDENTAL_DEATH, DIABETES, CELL_PROTECTION, CASH_ROBBERY, HOSPITAL_CARE, HOSPITALIZATION]

    activation_atstring<date-time>required

    Timestamp from which the authorization can be redeemed. ISO 8601.

    expiration_atstring<date-time>required

    Timestamp after which the authorization can no longer be redeemed. ISO 8601.