# Search Purchase Orders

> Perform Search Purchase Orders through ClaimSoft.

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

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

- Handler: `claimsoft_search_purchase_orders`

- Connection type: `claimsoft`

## Inputs

- `search_text` — Search Text (text)
  Optional text value.
- `order_status` — Order Status (multi_select)
  Optional list of selected values.
  Default: `["2","3","4","6"]`
  Options: Open ("2"), Due ("3"), Closed ("4"), Deleted ("6")
- `warehouses` — Warehouses (json)
  Optional JSON value.
- `patient_id` — Patient Id (expression)
  Optional literal value or workflow expression.
- `practitioner_id` — Practitioner Id (expression)
  Optional literal value or workflow expression.
- `date_from` — Date From (date)
  Optional date in YYYY-MM-DD format.
- `date_to` — Date To (date)
  Optional date in YYYY-MM-DD format.
- `filters` — Filters (json)
  Optional JSON value.
- `max_rows` — Max Rows (number)
  Optional numeric value.
  Default: `500`

## Outputs

- `server_returned` — Server Returned
- `returned` — Returned
- `client_truncated` — Client Truncated
- `orders` — Orders
- `inventory_url` — Inventory Url
- `error` — Error

Output schema completeness: `best_effort_declared`

## Safety

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

## Schemas

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

### Input schema

```json
{
  "type": "object",
  "properties": {
    "date_to": {
      "type": "string",
      "format": "date",
      "description": "Optional date in YYYY-MM-DD format.",
      "x-workflow-field-type": "date"
    },
    "filters": {
      "description": "Optional JSON value.",
      "x-workflow-field-type": "json"
    },
    "max_rows": {
      "type": "number",
      "default": 500,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "date_from": {
      "type": "string",
      "format": "date",
      "description": "Optional date in YYYY-MM-DD format.",
      "x-workflow-field-type": "date"
    },
    "patient_id": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "warehouses": {
      "description": "Optional JSON value.",
      "x-workflow-field-type": "json"
    },
    "search_text": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "order_status": {
      "type": "array",
      "items": {
        "enum": [
          "2",
          "3",
          "4",
          "6"
        ],
        "type": "string"
      },
      "default": [
        "2",
        "3",
        "4",
        "6"
      ],
      "description": "Optional list of selected values.",
      "x-workflow-field-type": "multi_select"
    },
    "practitioner_id": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "error": {},
    "orders": {},
    "returned": {},
    "inventory_url": {},
    "server_returned": {},
    "client_truncated": {}
  },
  "additionalProperties": true
}
```