Skip to documentation
NikoHealth integration

Rule-Based Task Router

Perform Rule-Based Task Router through NikoHealth.

View as Markdown
nikohealth_rule_based_task_router
writenikohealth

Inputs

  • document_id
    expressionrequired
    Document Id

    Required literal value or workflow expression.

  • patient_id
    expression
    Patient Id

    Optional literal value or workflow expression.

  • has_patient_data
    expression
    Has Patient Data

    Optional literal value or workflow expression.

  • has_order_data
    expression
    Has Order Data

    Optional literal value or workflow expression.

  • is_new_patient
    expression
    Is New Patient

    Optional literal value or workflow expression.

  • document_type
    expression
    Document Type

    Optional literal value or workflow expression.

  • is_carecentrix
    expression
    Is Carecentrix

    Optional literal value or workflow expression.

  • has_resupply
    expression
    Has Resupply

    Optional literal value or workflow expression.

  • has_pending_authorization
    expression
    Has Pending Authorization

    Optional literal value or workflow expression.

  • referring_provider_name
    expression
    Referring Provider Name

    Optional literal value or workflow expression.

  • ocr_text
    expression
    Ocr Text

    Optional literal value or workflow expression.

  • document_url
    expression
    Document Url

    Optional literal value or workflow expression.

  • enable_strategy_title_triage
    boolean
    Enable Strategy Title Triage

    Optional true-or-false value.

    Default: false

  • routing_rules
    repeatable_group
    Routing Rules

    Optional list of structured items.

    • enabled
      boolean
      Enabled

      Optional true-or-false value.

      Default: true

    • priority
      text
      Priority

      Optional text value.

      Default: "100"

    • name
      textrequired
      Name

      Required text value.

    • condition_flags
      multi_select
      Condition Flags

      Optional list of selected values.

      Options: Has patient data ("has_patient_data"), No patient data ("no_patient_data"), Has order data ("has_order_data"), No order data ("no_order_data"), Supports order tasking ("supports_order_tasking"), Does not support order tasking ("not_supports_order_tasking"), New patient ("is_new_patient"), Existing patient ("is_existing_patient"), Has resupply ("has_resupply"), No resupply ("no_resupply"), Has pending authorization ("has_pending_authorization"), No pending authorization ("no_pending_authorization"), Referral signal ("has_referral_signal"), No referral signal ("no_referral_signal"), WellSky referral ("is_wellsky_referral"), Not WellSky referral ("not_wellsky_referral")

    • document_types
      multi_select
      Document Types

      Optional list of selected values.

    • ocr_contains_any
      multi_select
      Ocr Contains Any

      Optional list of selected values.

    • ocr_contains_all
      multi_select
      Ocr Contains All

      Optional list of selected values.

    • provider_contains_any
      multi_select
      Provider Contains Any

      Optional list of selected values.

    • provider_resolution_mode
      select
      Provider Resolution Mode

      Optional selected identifier or value.

      Default: "configured_terms"

      Options: Configured provider terms ("configured_terms"), Strategy provider resolver ("strategy_provider_resolver")

    • custom_context_flags
      multi_select
      Custom Context Flags

      Optional list of selected values.

    • outcome_action
      select
      Outcome Action

      Optional selected identifier or value.

      Default: "create_task"

      Options: Create task ("create_task"), Complete without task ("complete_without_task"), Skip ("skip"), Fail tasking ("fail")

    • tasking_outcome
      text
      Tasking Outcome

      Optional text value.

    • task_category_id
      selectdynamic options
      Task Category Id

      Optional selected identifier or value. Retrieve allowed values from the dynamic options endpoint.

    • task_priority
      select
      Task Priority

      Optional selected identifier or value.

      Default: "Normal"

      Options: Normal ("Normal"), Low ("Low"), High ("High")

    • assignee_ids
      multi_selectdynamic options
      Assignee Ids

      Optional list of selected values. Retrieve allowed values from the dynamic options endpoint.

    • assignee_ids_manual
      expression
      Assignee Ids Manual

      Optional literal value or workflow expression.

    • pick_random_assignee
      boolean
      Pick Random Assignee

      Optional true-or-false value.

      Default: false

    • assignee_type
      select
      Assignee Type

      Optional selected identifier or value.

      Default: "user"

      Options: User ("user"), Team ("team")

    • assignee_resolution_mode
      select
      Assignee Resolution Mode

      Optional selected identifier or value.

      Default: "static"

      Options: Static assignees ("static"), Latest open task, fallback to assignees ("latest_open_task"), Latest authorization task, fallback to assignees ("latest_authorization_task")

    • title_template
      text
      Title Template

      Optional text value.

    • description_template
      textarea
      Description Template

      Optional text value.

    • attach_patient
      boolean
      Attach Patient

      Optional true-or-false value.

      Default: true

    • attach_legacy_document
      boolean
      Attach Legacy Document

      Optional true-or-false value.

      Default: true

Outputs

  • successSuccess
  • tasking_outcomeTasking Outcome
  • task_idTask Id
  • idempotentIdempotent
  • matched_ruleMatched Rule
  • matched_rule_sourceMatched Rule Source
  • document_idDocument Id
  • document_typeDocument Type
  • is_new_patientIs New Patient
  • supports_order_taskingSupports Order Tasking
  • custom_context_flagsCustom Context Flags
  • has_resupplyHas Resupply
  • has_pending_authorizationHas Pending Authorization
  • display_nameDisplay Name
  • skippedSkipped
  • messageMessage
  • error_codeError Code
  • error_typeError Type
  • errorError

Output schema completeness: best_effort_declared

Safety

External effect
write
Confirmation recommended
No
Retry safe
No
Dry run supported
No

Schemas

These schemas are first-pass authoring guidance. Runtime validation remains authoritative.

Input schema
{
  "type": "object",
  "required": [
    "document_id"
  ],
  "properties": {
    "ocr_text": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "patient_id": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "document_id": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "document_url": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "has_resupply": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "document_type": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "routing_rules": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Required text value.",
            "x-workflow-field-type": "text"
          },
          "enabled": {
            "type": "boolean",
            "default": true,
            "description": "Optional true-or-false value.",
            "x-workflow-field-type": "boolean"
          },
          "priority": {
            "type": "string",
            "default": "100",
            "description": "Optional text value.",
            "x-workflow-field-type": "text"
          },
          "assignee_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional list of selected values. Retrieve allowed values from the dynamic options endpoint.",
            "x-dynamic-options": true,
            "x-workflow-field-type": "multi_select"
          },
          "assignee_type": {
            "enum": [
              "user",
              "team"
            ],
            "type": "string",
            "default": "user",
            "description": "Optional selected identifier or value.",
            "x-workflow-field-type": "select"
          },
          "task_priority": {
            "enum": [
              "Normal",
              "Low",
              "High"
            ],
            "type": "string",
            "default": "Normal",
            "description": "Optional selected identifier or value.",
            "x-workflow-field-type": "select"
          },
          "attach_patient": {
            "type": "boolean",
            "default": true,
            "description": "Optional true-or-false value.",
            "x-workflow-field-type": "boolean"
          },
          "document_types": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional list of selected values.",
            "x-workflow-field-type": "multi_select"
          },
          "outcome_action": {
            "enum": [
              "create_task",
              "complete_without_task",
              "skip",
              "fail"
            ],
            "type": "string",
            "default": "create_task",
            "description": "Optional selected identifier or value.",
            "x-workflow-field-type": "select"
          },
          "title_template": {
            "type": "string",
            "description": "Optional text value.",
            "x-workflow-field-type": "text"
          },
          "condition_flags": {
            "type": "array",
            "items": {
              "enum": [
                "has_patient_data",
                "no_patient_data",
                "has_order_data",
                "no_order_data",
                "supports_order_tasking",
                "not_supports_order_tasking",
                "is_new_patient",
                "is_existing_patient",
                "has_resupply",
                "no_resupply",
                "has_pending_authorization",
                "no_pending_authorization",
                "has_referral_signal",
                "no_referral_signal",
                "is_wellsky_referral",
                "not_wellsky_referral"
              ],
              "type": "string"
            },
            "description": "Optional list of selected values.",
            "x-workflow-field-type": "multi_select"
          },
          "tasking_outcome": {
            "type": "string",
            "description": "Optional text value.",
            "x-workflow-field-type": "text"
          },
          "ocr_contains_all": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional list of selected values.",
            "x-workflow-field-type": "multi_select"
          },
          "ocr_contains_any": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional list of selected values.",
            "x-workflow-field-type": "multi_select"
          },
          "task_category_id": {
            "type": "string",
            "description": "Optional selected identifier or value. Retrieve allowed values from the dynamic options endpoint.",
            "x-dynamic-options": true,
            "x-workflow-field-type": "select"
          },
          "assignee_ids_manual": {
            "description": "Optional literal value or workflow expression.",
            "x-workflow-field-type": "expression"
          },
          "custom_context_flags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional list of selected values.",
            "x-workflow-field-type": "multi_select"
          },
          "description_template": {
            "type": "string",
            "description": "Optional text value.",
            "x-workflow-field-type": "textarea"
          },
          "pick_random_assignee": {
            "type": "boolean",
            "default": false,
            "description": "Optional true-or-false value.",
            "x-workflow-field-type": "boolean"
          },
          "provider_contains_any": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional list of selected values.",
            "x-workflow-field-type": "multi_select"
          },
          "attach_legacy_document": {
            "type": "boolean",
            "default": true,
            "description": "Optional true-or-false value.",
            "x-workflow-field-type": "boolean"
          },
          "assignee_resolution_mode": {
            "enum": [
              "static",
              "latest_open_task",
              "latest_authorization_task"
            ],
            "type": "string",
            "default": "static",
            "description": "Optional selected identifier or value.",
            "x-workflow-field-type": "select"
          },
          "provider_resolution_mode": {
            "enum": [
              "configured_terms",
              "strategy_provider_resolver"
            ],
            "type": "string",
            "default": "configured_terms",
            "description": "Optional selected identifier or value.",
            "x-workflow-field-type": "select"
          }
        },
        "additionalProperties": false
      },
      "description": "Optional list of structured items.",
      "x-workflow-field-type": "repeatable_group"
    },
    "has_order_data": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "is_carecentrix": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "is_new_patient": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "has_patient_data": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "referring_provider_name": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "has_pending_authorization": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "enable_strategy_title_triage": {
      "type": "boolean",
      "default": false,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    }
  },
  "additionalProperties": false
}
Output schema
{
  "type": "object",
  "properties": {
    "error": {},
    "message": {},
    "skipped": {},
    "success": {},
    "task_id": {},
    "error_code": {},
    "error_type": {},
    "idempotent": {},
    "document_id": {},
    "display_name": {},
    "has_resupply": {},
    "matched_rule": {},
    "document_type": {},
    "is_new_patient": {},
    "tasking_outcome": {},
    "matched_rule_source": {},
    "custom_context_flags": {},
    "supports_order_tasking": {},
    "has_pending_authorization": {}
  },
  "additionalProperties": true
}
View all NikoHealth actions