Create Invoice
Perform Create Invoice through NikoHealth.
nikohealth_create_claimInputs
- Patient Id
patient_idexpressionrequiredRequired literal value or workflow expression.
- Hcpcs Code
hcpcs_codetextrequiredRequired text value.
- Service Date From
service_date_fromexpressionrequiredRequired literal value or workflow expression.
- Service Date To
service_date_toexpressionOptional literal value or workflow expression.
- Billing Provider Name
billing_provider_nametextrequiredRequired text value.
- Referring Provider Id
referring_provider_idexpressionrequiredRequired literal value or workflow expression.
- Diagnosis Codes
diagnosis_codesexpressionrequiredRequired literal value or workflow expression.
- Insurance Id
insurance_idexpressionOptional literal value or workflow expression.
- Place Of Service
place_of_servicetextOptional text value.
Default:
"12" - Quantity
quantitynumberOptional numeric value.
Default:
1 - Status
statustextOptional text value.
Default:
"New" - Resubmission Code
resubmission_codetextOptional text value.
Default:
"Original" - Order Id
order_idexpressionOptional literal value or workflow expression.
- Prefer Latest Order
prefer_latest_orderbooleanOptional true-or-false value.
Default:
false - Product Id
product_idexpressionOptional literal value or workflow expression.
- Product Name
product_nametextOptional text value.
- Line Name
line_nametextOptional text value.
- Modifiers
modifiersexpressionOptional literal value or workflow expression.
- Price Option Id
price_option_idexpressionOptional literal value or workflow expression.
- Sale Type
sale_typeselectOptional selected identifier or value.
Default:
"Purchase"Options: Purchase ("Purchase"), Rental ("Rental")
- Require Patient Diagnoses
require_patient_diagnosesbooleanOptional true-or-false value.
Default:
true - Fail On Restrictions
fail_on_restrictionsbooleanOptional true-or-false value.
Default:
true - Skip If Empty
skip_if_emptybooleanOptional true-or-false value.
Default:
false - Dry Run
dry_runbooleanOptional true-or-false value.
Default:
false
Outputs
successSuccessskippedSkippedstatusStatusclaim_idClaim Idcan_submitCan Submitprice_option_idPrice Option IdchargeChargeallowedAllowedmodifiersModifiersbilling_provider_nameBilling Provider Nameinsurance_idInsurance Idorder_idOrder Idproduct_idProduct Idproduct_nameProduct Nameproduct_sourceProduct Sourceproduct_candidates_countProduct Candidates Countrestriction_warningsRestriction Warningsrestriction_codesRestriction Codesvalidation_errorsValidation ErrorspayloadPayloaddry_runDry RunerrorError
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
{
"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
{
"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
}