# Create Invoice

> Perform Create Invoice through NikoHealth.

Source: [https://genhealth.ai/docs/workflows/integrations/nikohealth/nikohealth_create_claim](https://genhealth.ai/docs/workflows/integrations/nikohealth/nikohealth_create_claim)

Integration: [NikoHealth](https://genhealth.ai/docs/workflows/integrations/nikohealth.md)

- Handler: `nikohealth_create_claim`

- Connection type: `nikohealth`

## Inputs

- `patient_id` — Patient Id (expression, required)
  Required literal value or workflow expression.
- `hcpcs_code` — Hcpcs Code (text, required)
  Required text value.
- `service_date_from` — Service Date From (expression, required)
  Required literal value or workflow expression.
- `service_date_to` — Service Date To (expression)
  Optional literal value or workflow expression.
- `billing_provider_name` — Billing Provider Name (text, required)
  Required text value.
- `referring_provider_id` — Referring Provider Id (expression, required)
  Required literal value or workflow expression.
- `diagnosis_codes` — Diagnosis Codes (expression, required)
  Required literal value or workflow expression.
- `insurance_id` — Insurance Id (expression)
  Optional literal value or workflow expression.
- `place_of_service` — Place Of Service (text)
  Optional text value.
  Default: `"12"`
- `quantity` — Quantity (number)
  Optional numeric value.
  Default: `1`
- `status` — Status (text)
  Optional text value.
  Default: `"New"`
- `resubmission_code` — Resubmission Code (text)
  Optional text value.
  Default: `"Original"`
- `order_id` — Order Id (expression)
  Optional literal value or workflow expression.
- `prefer_latest_order` — Prefer Latest Order (boolean)
  Optional true-or-false value.
  Default: `false`
- `product_id` — Product Id (expression)
  Optional literal value or workflow expression.
- `product_name` — Product Name (text)
  Optional text value.
- `line_name` — Line Name (text)
  Optional text value.
- `modifiers` — Modifiers (expression)
  Optional literal value or workflow expression.
- `price_option_id` — Price Option Id (expression)
  Optional literal value or workflow expression.
- `sale_type` — Sale Type (select)
  Optional selected identifier or value.
  Default: `"Purchase"`
  Options: Purchase ("Purchase"), Rental ("Rental")
- `require_patient_diagnoses` — Require Patient Diagnoses (boolean)
  Optional true-or-false value.
  Default: `true`
- `fail_on_restrictions` — Fail On Restrictions (boolean)
  Optional true-or-false value.
  Default: `true`
- `skip_if_empty` — Skip If Empty (boolean)
  Optional true-or-false value.
  Default: `false`
- `dry_run` — Dry Run (boolean)
  Optional true-or-false value.
  Default: `false`

## Outputs

- `success` — Success
- `skipped` — Skipped
- `status` — Status
- `claim_id` — Claim Id
- `can_submit` — Can Submit
- `price_option_id` — Price Option Id
- `charge` — Charge
- `allowed` — Allowed
- `modifiers` — Modifiers
- `billing_provider_name` — Billing Provider Name
- `insurance_id` — Insurance Id
- `order_id` — Order Id
- `product_id` — Product Id
- `product_name` — Product Name
- `product_source` — Product Source
- `product_candidates_count` — Product Candidates Count
- `restriction_warnings` — Restriction Warnings
- `restriction_codes` — Restriction Codes
- `validation_errors` — Validation Errors
- `payload` — Payload
- `dry_run` — Dry Run
- `error` — Error

Output schema completeness: `best_effort_declared`

## Safety

- External effect: `irreversible`
- Confirmation recommended: yes
- 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": [
    "patient_id",
    "hcpcs_code",
    "service_date_from",
    "billing_provider_name",
    "referring_provider_id",
    "diagnosis_codes"
  ],
  "properties": {
    "status": {
      "type": "string",
      "default": "New",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "dry_run": {
      "type": "boolean",
      "default": false,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "order_id": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "quantity": {
      "type": "number",
      "default": 1,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "line_name": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "modifiers": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "sale_type": {
      "enum": [
        "Purchase",
        "Rental"
      ],
      "type": "string",
      "default": "Purchase",
      "description": "Optional selected identifier or value.",
      "x-workflow-field-type": "select"
    },
    "hcpcs_code": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "patient_id": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "product_id": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "insurance_id": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "product_name": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "skip_if_empty": {
      "type": "boolean",
      "default": false,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "diagnosis_codes": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "price_option_id": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "service_date_to": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "place_of_service": {
      "type": "string",
      "default": "12",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "resubmission_code": {
      "type": "string",
      "default": "Original",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "service_date_from": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "prefer_latest_order": {
      "type": "boolean",
      "default": false,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "fail_on_restrictions": {
      "type": "boolean",
      "default": true,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "billing_provider_name": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "referring_provider_id": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "require_patient_diagnoses": {
      "type": "boolean",
      "default": true,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "error": {},
    "charge": {},
    "status": {},
    "allowed": {},
    "dry_run": {},
    "payload": {},
    "skipped": {},
    "success": {},
    "claim_id": {},
    "order_id": {},
    "modifiers": {},
    "can_submit": {},
    "product_id": {},
    "insurance_id": {},
    "product_name": {},
    "product_source": {},
    "price_option_id": {},
    "restriction_codes": {},
    "validation_errors": {},
    "restriction_warnings": {},
    "billing_provider_name": {},
    "product_candidates_count": {}
  },
  "additionalProperties": true
}
```