Integrated Medicare Easyclaim

According to the Medicare Australia web site, "Medicare Easyclaim is a quick, easy, secure and convenient way for you to claim your rebate at the doctor’s". "If you normally pay to see your doctor, Medicare Easyclaim lets you claim your benefit, using the EFTPOS terminal in your doctor’s practice. Your benefit is paid directly into your cheque or savings account almost immediately."

The Integrated Medicare Easyclaim feature supports 3 different types of claims:

  1. Bulk bill claims.
  2. Fully paid claims.
  3. 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:

  1. Tyro Integration Server Simulator
  2. 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
  1. 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:

  1. PAID: The claim has been approved by Medicare and Tyro can go ahead with the refund.
  2. NAC: The claim has not been accepted and no benefit is payable.
  3. 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.
  4. 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.
Copyright © Tyro Payments 2019-2022. All right reserved.