Integrated Medicare Easyclaim
The Integrated Medicare Easyclaim feature supports 3 different types of claims:
- Bulk bill claims.
- Fully paid claims.
- Part paid claims.
Please refer to the specifications in the EasyClaim Logic Pack Users Guide v2
Methods
Please note that integrated receipts are not supported for Medicare Easyclaims.
- Tyro.Integ.Domain.ITransactionResult BulkBillClaim(string payload, bool rightsAssigned): To commence a bulk bill claim. The payload parameter is the Medicare Easyclaim XML payload for the claim. The rightsAssigned parameter whether the patient assigned their right to the benefit before seeing the doctor or during the claim process. This feature is for large practices whose workflow is where the patient signs for the claim prior to seeing the doctor and where the patient does not return to reception after being seen by the doctor.
- Tyro.Integ.Domain.ITransactionResult BulkBillClaimMidTid(string merchantID, string terminalID, string payload, bool rightsAssigned): Same as above, but allowing a specific Merchant ID and Terminal ID to be specified, for multi-merchant capable terminals.
- Tyro.Integ.Domain.ITransactionResult FullyPaidClaim(string payload): To commence a fully paid claim. The payload parameter is the Medicare Easyclaim XML payload for the claim.
- Tyro.Integ.Domain.ITransactionResult FullyPaidClaimMidTid(string merchantID, string terminalID, string payload): Same as above, but allowing a specific Merchant ID and Terminal ID to be specified, for multi-merchant capable terminals.
- Tyro.Integ.Domain.ITransactionResult PartPaidClaim(string payload): To commence a part paid claim. The payload parameter is the Medicare Easyclaim XML payload for the claim.
- Tyro.Integ.Domain.ITransactionResult PartPaidClaimMidTid(string merchantID, string terminalID, string payload): Same as above, but allowing a specific Merchant ID and Terminal ID to be specified, for multi-merchant capable terminals.
Return Value
The ITransactionResult interface contains the following methods:
- boolean ErrorOccurred() : This method returns a flag that indicates whether an error occurred during the transaction. The asynchronous interface will conclude a transaction by either raising a TransactionCompleted or an ErrorOccurred event, which respectively either indicates that it was possible for the TTA to discover what the result of the transaction was on the terminal, or that there was some error that prevented the TTA from discovering what that conclusion was. The synchronous interface stupports these interface semantics through this method, which allows the caller to determine whether or not the TTA was able to follow the transaction to conclusion on the terminal or not. If this flag is false, then the caller should call the GetTransaction() method on this object to learn of the final state of the transaction. If the flag is true, then the caller should call GetError() to learn of why the transaction failed.
- ITransaction GetTransaction(): Call this method if the ErrorOccurred() method returned false, meaning that the transaction has completed on the terminal. It returns a ITransaction object with the following methods:
- string[] GetReceipts() : A string array of all of the receipts for this transaction, in the order in which they were produced by the terminal. This is always empty for Medicare Easyclaim transactions as integrated receipts are not supported for Medicare Easyclaim transactions.
- string GetStatus() : The status of the transaction, as a String. Can be either "PENDING" or "COMPLETE".
- string GetTransactionReference() : Not used in Medicare Easyclaim transactions.
- string GetTipCompletionReference() : Deprecated. Not used in Medicare Easyclaim transactions.
- string GetTipAmount() : Not used in Medicare Easyclaim transactions.
- string GetAuthorisationCode() : Not used in Medicare Easyclaim transactions.
- string GetResult() : The result of this transaction, as a block of XML. Can be also be "SYSTEM ERROR" in the case of a system error or "TRANSACTION CANCELLED" if the transaction was cancelled.
- string GetCardType() : The card type used in the refund component of the transaction. Currently only EFTPOS cards are acceptable for the refund so this field will always be "EFTPOS".
- string GetID() : The identifier for this transaction on the Tyro Terminal.
- string GetEasyclaimTransactionID() : The Medicare Easyclaim transaction ID used. (Only for Medicare Easyclaim integration).
- IError GetError(): Call this method if the ErrorOccurred() method returned true, meaning that the TTA could not determine if the transaction had completed on the Tyro terminal. It returns a IError object with the following methods:
- string GetErrorMessage() : A plain english description of the error.
- boolean IsTransactionStarted() : An indication of whether the Terminal Adapter has sent the request to commence the transaction. If this is false, then the POS operator does not need to be concerned with finding the final status of the transaction.
- string GetTransactionID() : The identifier for this transaction on the Tyro Terminal.
Testing Integrated Medicare Easyclaim
The are two systems that we provide that Practice Management Systems (PMS) providers can use to test their Integrated Medicare Easyclaim development against:
- Tyro Integration Server Simulator
- Tyro Pre-production system
Both of these systems are discussed in more detail in the following sections.
Both of these systems are connected to a test Medicare Easyclaim system maintained by Medicare. To send test payloads through to the test Medicare Easyclaim system, Medicare have provided us with the following test patient card and provider details:
First Name | Last Name | Medicare Card | IRN | DOB | Gender | Street | Suburb | State | Postcode |
---|---|---|---|---|---|---|---|---|---|
Stuart | LOSCH | 6951783271 | 1 | 6-Jun-69 | M | 138 Law Gr | Dampier | WA | 6713 |
Maynard | FOWLER | 4951605331 | 1 | 25-May-67 | M | 163 Plaza Rdge | Mount Mulgrave | QLD | 4871 |
Emerson | CALLOW | 2954471021 | 1 | 2-Sep-59 | M | 127 Warrego Est | Kurrajong | NSW | 2758 |
Odell | PALMER | 4951605421 | 1 | 7-Apr-01 | M | 6 Cheddar Pde | Lanefield | QLD | 4340 |
Joleen | ALLAN | 4951605511 | 1 | 12-Apr-75 | F | 130 Cresson St | Dalma | QLD | 4702 |
Rachael | SHEA | 2954471111 | 1 | 6-Feb-96 | F | 82 Israel Rdge | Cooleys Creek | NSW | 2729 |
Randy | LEARY | 3951300341 | 1 | 28-Oct-52 | M | 171 West Cr | Hallston | VIC | 3953 |
Dennis | LESLIE | 2954471201 | 1 | 13-Jun-00 | M | 33 Compton Est | Murrulebale | NSW | 2652 |
- These providers can be used as servicing, payee, or referring providers.
Provider Number | Last Name | First Name | Equipment Number | Pathology Provider |
---|---|---|---|---|
2147661H | Renoux | Yerda | 901 | No |
2147661F | Pilatic | Prue | 901 | No |
2159081W | Josie | Amedos | N/A | Yes |
Notes
- If transmitting claims for Diagnostic Imaging, claims please use the LSPN Number 14.
- If transmitting claims for Pathology please use SCP Number 001.
- If transmitting claims for Radiation Oncology please use the Equipment Number supplied.
- The following providers may be used for Referral / Request purposes only.
Provider Type | Provider Number | Name |
---|---|---|
General | 2054781W | Dr Brenda Reed |
Specialist | 2121331W | Dr Vivian Mortier |
The TTA comes with sample applications that show how to use the TTA to integrate with Medicare Easyclaim.
A note on Fully Paid claims
When a Fully Paid Medicare Easyclaim response is marked as APPROVED, this only means that we successfully submitted the claim to Medicare and received a response. It does not necessarily mean that the claim was approved or that the patient's bank account has been credited. To determine the outcome of the claim the medicareAcceptanceType attribute in the response should be determine as it will show the outcome of the claim. The possible values of medicareAcceptanceType are:
- PAID: The claim has been approved by Medicare and Tyro can go ahead with the refund.
- NAC: The claim has not been accepted and no benefit is payable.
- PEND: For “pended” patient claims where the claimant has not paid or only partially paid the accounts, Medicare Australia will issue a statement and a cheque made in favour of the Medical Practitioner where a benefit is payable, and forward to the claimant’s address recorded by Medicare Australia.
- PDVC: Medicare Australia will issue a statement and the Pay Doctor via Claimant (PDVC) cheque, which is mailed to the claimant’s address recorded by Medicare Australia. This would be the case when a partly paid or a unpaid patient claim is submitted.