# Advance Reviewed Orders

> Perform Advance Reviewed Orders through ClaimSoft.

Source: [https://genhealth.ai/docs/workflows/integrations/claim-soft/claimsoft_advance_reviewed_orders](https://genhealth.ai/docs/workflows/integrations/claim-soft/claimsoft_advance_reviewed_orders)

Integration: [ClaimSoft](https://genhealth.ai/docs/workflows/integrations/claim-soft.md)

- Handler: `claimsoft_advance_reviewed_orders`

- Connection type: `claimsoft`

## Use in a workflow

Copy this discovered node config, fill params from the input contract, and validate the complete graph. Integration results are available as {{node_id.default.field}}. Check business success before dependent writes; completion alone does not prove business success.

```json

{
  "_group": "ClaimSoft",
  "params": {
    "dry_run": true,
    "max_orders": 25,
    "max_evaluations": 150,
    "backlog_lookback_days": 7,
    "mark_reviews_complete": true
  },
  "handler": "claimsoft_advance_reviewed_orders"
}

```

[Action contracts](https://genhealth.ai/docs/workflows/action-contracts.md) · [Run recovery](https://genhealth.ai/docs/workflows/operations.md)

## Inputs

- `selected_items` — Selected Items (json)
  Optional JSON value.
- `supported_hcpcs` — Supported Hcpcs (json, required)
  Required JSON value.
- `from_alert_type_id` — From Alert Type Id (text, required)
  Required text value.
- `to_alert_type_id` — To Alert Type Id (text, required)
  Required text value.
- `comment_text` — Comment Text (text, required)
  Required text value.
- `approve_recommendations` — Approve Recommendations (json, required)
  Required JSON value.
- `blocked_comment_patterns` — Blocked Comment Patterns (json)
  Optional JSON value.
- `blocked_hcpcs` — Blocked Hcpcs (json)
  Optional JSON value.
- `held_order_ids` — Held Order Ids (json)
  Optional JSON value.
- `required_order_status` — Required Order Status (number, required)
  Required numeric value.
- `required_responsible_party` — Required Responsible Party (number, required)
  Required numeric value.
- `dry_run` — Dry Run (boolean)
  Optional true-or-false value.
  Default: `true`
- `max_orders` — Max Orders (number)
  Optional numeric value.
  Default: `25`
- `max_evaluations` — Max Evaluations (number)
  Optional numeric value.
  Default: `150`
- `backlog_lookback_days` — Backlog Lookback Days (number)
  Optional numeric value.
  Default: `7`
- `mark_reviews_complete` — Mark Reviews Complete (boolean)
  Optional true-or-false value.
  Default: `true`

## Outputs

- `success` — Success
- `dry_run` — Dry Run
- `evaluated_count` — Evaluated Count
- `advanced_count` — Advanced Count
- `would_advance_count` — Would Advance Count
- `completed_existing_count` — Completed Existing Count
- `would_complete_existing_count` — Would Complete Existing Count
- `skipped_count` — Skipped Count
- `deferred_count` — Deferred Count
- `completed_document_count` — Completed Document Count
- `budget_exhausted` — Budget Exhausted
- `orders` — Orders
- `error` — Error

Output schema completeness: `best_effort_declared`

## Safety

- External effect: `write`
- Confirmation recommended: no
- Retry safe: no
- Dry run supported: yes

## Schemas

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

### Input schema

```json
{
  "type": "object",
  "required": [
    "supported_hcpcs",
    "from_alert_type_id",
    "to_alert_type_id",
    "comment_text",
    "approve_recommendations",
    "required_order_status",
    "required_responsible_party"
  ],
  "properties": {
    "dry_run": {
      "type": "boolean",
      "default": true,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "max_orders": {
      "type": "number",
      "default": 25,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "comment_text": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "blocked_hcpcs": {
      "description": "Optional JSON value.",
      "x-workflow-field-type": "json"
    },
    "held_order_ids": {
      "description": "Optional JSON value.",
      "x-workflow-field-type": "json"
    },
    "selected_items": {
      "description": "Optional JSON value.",
      "x-workflow-field-type": "json"
    },
    "max_evaluations": {
      "type": "number",
      "default": 150,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "supported_hcpcs": {
      "description": "Required JSON value.",
      "x-workflow-field-type": "json"
    },
    "to_alert_type_id": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "from_alert_type_id": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "backlog_lookback_days": {
      "type": "number",
      "default": 7,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "mark_reviews_complete": {
      "type": "boolean",
      "default": true,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "required_order_status": {
      "type": "number",
      "description": "Required numeric value.",
      "x-workflow-field-type": "number"
    },
    "approve_recommendations": {
      "description": "Required JSON value.",
      "x-workflow-field-type": "json"
    },
    "blocked_comment_patterns": {
      "description": "Optional JSON value.",
      "x-workflow-field-type": "json"
    },
    "required_responsible_party": {
      "type": "number",
      "description": "Required numeric value.",
      "x-workflow-field-type": "number"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "error": {},
    "orders": {},
    "dry_run": {},
    "success": {},
    "skipped_count": {},
    "advanced_count": {},
    "deferred_count": {},
    "evaluated_count": {},
    "budget_exhausted": {},
    "would_advance_count": {},
    "completed_document_count": {},
    "completed_existing_count": {},
    "would_complete_existing_count": {}
  },
  "additionalProperties": true
}
```