Submitting claims

Eligibility checks and quotes

Quotes and claims can be implemented as separate actions from the PMS by setting the isQuote property within funderData to either true for quote-only or false for claim-only mode. Alternatively, the SDK can be rendered with a toggle that allows the user to select between submitting a quote or a claim by omitting isQuote.

medipassPartnerSDK.renderCreateTransaction({
  platform: "funder",
  funder: "wsv",
  funderData: {
    wsv: {
      isQuote: true,
    }
  }
}, {
  version: "3"
});

On the quote modal, which is displayed after the quote has been submitted to WSV, there are three buttons available of which two are configurable. The “Dismiss quote” button that closes the quote modal is not configurable. The “Edit quote” button returns the user to the quote to make changes, while the “Submit as claim” button converts the quote to a claim and submits it to WorkSafe Vic, eliminating the need to re-key information. Both of these buttons are configurable, and may be displayed or hidden depending on what best suits the workflows in your software.

medipassPartnerSDK.renderCreateTransaction({
  platform: "funder",
  funder: "wsv",
  funderData: {
    wsv: {
      isQuote: true,
      enableEditQuote: true,
      enableSubmitQuoteAsClaim: true
    }
  }
}, {
  version: "3"
});

Provider and location details

Provider and practice location details can be set with a single providerNumber attribute. Importantly, this provider number must be defined and active in Tyro Health and for the given business API Key. Provider numbers which are not registered in Tyro Health or for the given business API key will error. Only one provider can claim per invoice.

Provider number formats can vary by professional category and issuing organisation. In general, the provider number will be defined as follows:

For the SDK, if a provider number is not sent in the claim payload, the the user will be prompted to manually select:

• The practice location
• Individual provider
• Provider profession type and/or specialist category
  

If only one of each category has been defined, that will be automatically selected.

Registration of provider numbers

Providers must first register with Tyro Health prior to submitting a WorkSafe Victoria claim. We do not currently offer an API for partners to self-register providers.

This registration process is self-service and can be completed within a few minutes. If providers deliver services from multiple locations or businesses, each unique provider number must be registered. Details on provider registration and WorkSafe Victoria activation is provided at: https://help.medipass.com.au/en/articles/5834449-enable-worksafe-victoria-digital-invoicing

Patients

Patients For WorkSafe Victoria, a claim requires one valid patient/injured worker. Multiple patients are not supported - each must be submitted as a separate claim. A claim requires:

• firstName : which can be up to 40 characters, and only contain alpha (A-Z and a-z), numeric (0- 9), space ( ), apostrophe (') and hyphen (- ) characters. Spaces must not appear before or after apostrophes, hyphens, other spaces or the supplied value. At least one alpha or numeric character required. If the patient has only one name, set that in the lastName field and set firstName to “onlyname”.
  
• lastName : which can be up to 40 characters, and only contain alpha (A-Z and a-z), numeric (0- 9), space ( ), apostrophe (') and hyphen (- ) characters. Spaces must not appear before or after apostrophes, hyphens, other spaces or the supplied value. At least one alpha or numeric character required.
  
• dob : Date of birth in YYYY-MM-DD format.
  
• accountNumber : should be set to the patient claim number, which is numeric and typically 12 digits long.
  
• refId (optional): An optional but highly recommended patient unique reference as set by you, such as a UUID/GUID. This value is used to uniquely identify a patient in the Tyro Health platform. Omitting refId will cause duplicate patient records to be created in Tyro Health and could make patient searches more difficult for providers who also use the Tyro Health portal to check on status of a claim and remittance. If supplied and valid, this value will pre-populate patient details from the patient record in the business as set in any prior claim. Any patient details set for an existing patient record will update those values and override what was previously stored.
  
• mobile (optional): patient mobile number either in international or national notation and used for uniquely searching for patients in the Tyro Health provider portal.
  

Patient details will be validated at time of claim submission and invalid details will be flagged with corresponding error details.

Items

Over 10,000 unique item codes - also referred to as service items, item numbers, material numbers or pay codes - are supported by Tyro Health for WWorkSafe Victoria claims. This includes most medical provider items defined in the Medicare Benefits Schedule (MBS), Pharmaceuticals as defined in the PBS and others as defined by WorkSafe Victoria. Multiple service items with different dates of service can be included in a single claim.

Multiple item code sources are supported by the WorkSafe Victoria integration. In general item types and item codes can be defined as follows:

Item codes are updated dynamically by WorkSafe Victoria and new codes will be automatically integrated into the Tyro Health platform. Current WorkSafe Victoria item codes can be obtained via : https://www.worksafe.vic.gov.au/information-for-providers

WorkSafe Victoria allows providers to determine their own fees for services. However, payment will only be made up to a maximum benefit amount for each service. If the amount charged by a provider exceeds WorkSafe Victoria's maximum price for an item, a warning will be displayed, but the item can be submitted and adjudicated as-is.

Approved claims will return a “benefit paid”, and the remaining amount will appear as a “gap” on the invoice. The service provider is permitted to charge the injured worker additional gap fees for amounts not covered by WorkSafe Victoria.

A valid claim will contain the following item attributes:

• reference (optional): optional but recommended, a line item unique reference as nominated by you such as a UUID/GUID. Assists with reconciliation where multiple of the same item code and service date are set in a claim. Up to 128 alphanumeric characters are permitted which must be unique for each service item in a claim.
  
• serviceDateString : date of service in YYYY-MM-DD format. Past service dates - up to two years from submission date - are supported.
  
• itemCode : up to 12 characters. The item code must be applicable for a given service date and provider registered professional category. For MBS items, leading zeros are permitted or may be omitted. Items which are not known or invalid for a given service date or profession will be flagged with an error at the item level.
  
• price : net (excluding GST) price each unit in $XX.XX format.
  
• quantity (optional): by default, the quantity is 1. Quantity greater than 1 should only be used when the item unit of measure is Quantity Dispensed or for Kilometres. If the provider is charging for multiple items where the unit of measure is each, those should be listed as separate items rather than a single item with multiple quantity.
  

Units of measure vary depending on item code. The current supported WorkSafe Victoria units of measure include:

• description (optional): a description of the item up to 128 characters. Only used and required for special catch-all items, such as AP001 - aids & appliances. If a description is required for the item and not provided, an error response will be returned at the item level.
  
• gstInclusiveFlag (optional): indicates if GST should be applied for the item. Note that services delivered to a patient are typically GST free. Services delivered for the insurer/agent may attract GST. Default is false. If set to true, GST of 10% will be added to the price amount.
  
• serviceTime (optional): time of service in HH:MM in a 24 hour cycle. Typically only set if duplicate items are charged for the same service date or after-hours items are charged.
  
• numberOfPatientsSeen (optional): only applicable for item codes which require the provider to state the number of patients seen, such as MBS items 4, 24, 37 or other group attendance items.
  

For Pharmacy items, the following item attributes apply when the item is dispensed as a private script. Pharmacy items dispensed under the PBS will not require these attributes.

• prescriberFirstName : first name of the prescribing provider, such as a GP or specialist. Up to 40 characters.
  
• prescriberLastName : last name of the prescribing provider, such as a GP or specialist. Up to 40 characters.
  
• prescriberNumber : typically the Medicare issued provider number of the prescribing GP or specialist.
  
• scriptNumber : prescribing provider script number.
  
• authorityNumber r: prescribing provider authority number.