Claiming Process

Learn about the Claiming Process under Support at Home within Maica

The Claiming Process in Maica enables you to submit Support at Home claims directly to Services Australia, retrieve real-time updates on their status, and automatically reconcile your invoice records.

This article provides a step-by-step walkthrough of each stage in the claiming workflow — continue reading below to learn more.

Note: This process is linear and should be followed in order. Each step builds on the one before.

1. Generate Claim Batch and Payment Requests

The first step in the claiming process is to generate a Support at Home Claim Batch. This batch is created based on a set of filter criteria you define — such as a service date range, service provider, and funding type — and is used to group the Invoice Line Items you intend to claim. As part of this process, Payment Request records are also created automatically.

Start by selecting the Generate Claim Batch quick action. This will open a modal window where you can configure the parameters for your batch, as shown below.

In order to launch the Generate Claim Batch Action, first head to the App Launch and search for Claim Batches. Click New and create one with the desired dates.

You’ll be prompted to complete the following fields:

  • Start Date and End Date Use these fields to define the service period for which you want to generate claims.

  • Service Provider Select one or more service providers. This field supports multiple selections and behaves like a lookup. This is an optional field.

  • Funding Type Choose the appropriate funding type from the picklist, which in this case is Support at Home.

These filters allow you to limit the batch to specific invoice line items based on provider, funding structure, and service date.

Once you confirm your selections, hit Generate Claim, and Maica will retrieve all Invoice Line Item records that match the criteria, as shown below.

For each record:

  • A Payment Request is generated and linked to the line item.

  • Both the line item and payment request are linked to the newly created Claim Batch via a lookup.

  • This completes the initial population of the batch.

At this step, you can also see all generated Payment Request records as part of the Claim Batch in an auto generated Report linked in the modal.

You can re-run the Generate Claim Batch action at any point before submission to refresh the records or include additional items.

Only Invoice Line Items where the related Invoice Claim Status is set to Open will be considered for inclusion in the batch. For more information on the Invoice Line Item Filtering Logic or Payment Request Field mapping, click here.

2. Upload Invoices and Invoice Line Items to Services Australia

Once the Claim Batch is populated, the next step is to upload all associated Invoice and Invoice Line Item records to Services Australia for processing. This step officially submits the claim.

To begin, click the Submit Claim button via the Quick Action on the Claim Batch.

A confirmation message will appear to notify you that this action is final:

You are about to submit this Claim Batch to the Support at Home funding system. Submitting this claim will initiate the official claiming process and update the Claim Status field on all associated Invoice records to submitted. Once an Invoice is marked as submitted, it can no longer be modified or included in future claiming cycles. Maica will also stop adding any new line items to these Invoices once the claim is submitted.

Once done, the modal will update and alert you that the Claim has been submitted, as shown below.

What Maica does behind the scenes?

Behind the scenes, Maica uses the Invoices API to post the claim data to Services Australia in the correct format.

Using the grouped Invoice Line Items from the batch:

  1. Invoices are submitted first:

    • A new Invoice is posted via the API.

    • Services Australia returns a unique Invoice ID.

    • This ID is saved to the Aged Care Invoice ID field.

    • Maica then updates the Invoice with:

      • Invoice Claim Status = SUBMITTED

      • Invoice Closure Date = Yesterday

  2. Invoice Line Items are submitted next:

    • Each line item is posted using the newly returned Services Australia Invoice ID as its parent.

    • On success, each line item receives a Services Australia Invoice Item ID, which is stored on the record.

The Services Australia data model aligns directly with Maica’s:

  • The Invoice object in Services Australia maps to Maica’s Invoice.

  • The Invoice Item (child) object maps to Invoice Line Item in Maica

Once done,

  • Invoice records are successfully submitted to Services Australia and marked as submitted in Maica.

  • Related Invoice Line Items are also posted and linked to their parent Invoices using the returned IDs.

To learn more, and see the Record Updates, click here.

3. Submit Claim Record to Services Australia

Once invoices and line items have been submitted, the final part of the submission process is to post the Claim Record to Services Australia. This claim acts as the container for the batch and links together all associated invoice data.

No additional user interaction is required. This step is triggered automatically as part of the Submit Claim quick action completed in Step 2.

Using the Claim API, Maica performs the following actions automatically:

  1. Creates a Claim Record

    • The system maps values from the Claim Batch and Maica Settings.

    • The payload is posted to Services Australia.

  2. Receives the Claim ID

    • Once submitted, Services Australia returns a Claim ID.

    • This ID is stored on the Claim Batch for future tracking.

  3. Links Invoices

    • An array of Invoice IDs is uploaded and associated with the Claim.

    • These IDs must match the records already submitted in Step 2.

To see the Claim API Mapping, click here.

Once done, a Claim Record is created and linked to the Invoices in Services Australia and the returned Claim ID is stored for visibility and future updates.

Additionally, once the Claim is successfully submitted and its status is returned as Claimed, a new quick action called Check Claim Status becomes available on the Claim Batch record. This is further explained in the next stage.

4. Check Claim Status

After submitting a Claim Batch to Services Australia, you can check on its progress to see whether it’s been approved or paid.

Here, you can selects the Check Claim Status quick action available on the Claim Batch record, as shown below. On click, Maica will make a callout to Services Australia and retrieve the most up-to-date Status — whether it’s still being processed or has reached a final outcome like Paid or Cancelled. You’ll see the current status update right on the Claim Batch screen, and in the modal, as shown below.

What Maica does behind the scenes?

When you click Check Claim Status, Maica connects with Services Australia using the Claim API and automatically:

  • Retrieves the current status of the submitted claim.

  • Updates the Claim Batch with the new status if it has changed.

  • Pulls in extra details if available — like the Claim Paid Date.

This helps Maica know when to trigger any follow-up steps or processes tied to that batch’s outcome.

To learn more about the full Claim API and Claim Response Field Mapping, click here.

Depending on the result, Maica will mark the Claim Batch as one of the following:

  • Being Calculated – Still in progress.

  • Pending Approval – Awaiting review.

  • Approved – Approved for payment (but not yet paid).

  • Paid – Payment completed (Maica will also store the Paid Date).

  • Cancelled – Claim was rejected or withdrawn.

Once done, the latest Claim Status and Claim Paid Date are updated on the Claim Batch record and Maica uses this new status to trigger any relevant downstream steps.

5. Retrieve Payment Statement and Update Claim Batch

Once your claim has been marked as Paid, Maica retrieves the final financial details from Services Australia.

You don’t need to click anything — this step runs automatically once the Claim Status updates to Paid.

As soon as the status is updated, Maica contacts Services Australia using the Payment Statement API and fetches all the payment breakdowns linked to your claim.

These include:

  • Claim Totals – The total value of the claim.

  • Paid Amounts – What Services Australia actually paid.

  • Held Over Amounts – If any portion was carried over or not yet paid.

  • Contributions or Reductions – Adjustments due to compensation, contributions, or prior period payments.

Maica then writes this data into the Claim Batch record.

You can see all the mappings and payload fields used in more detail here.

Now, your Claim Batch is enriched with final payment figures. This ensures your financial records are accurate and fully aligned with Services Australia’s reporting, without needing any manual reconciliation.

6. Retrieve Updated Invoice Statuses

After the claim is finalised and payment information has been retrieved, Maica takes one last step to make sure every related Invoice record is brought up to date.

No manual intervention is required here — it runs automatically behind the scenes.

Using the Invoices API, Maica reaches out to Services Australia with the original Claim ID and requests the latest status for all Invoices included in the batch.

Each Invoice is matched using its Aged Care Invoice ID (maica_cc__Aged_Care_Invoice_ID__c), and if Services Australia has updated the claim status, Maica syncs those changes directly into each related Invoice record.

To see the full Invoice API Mapping, click here.

Now Invoice records associated with the Claim Batch reflect their final processed status from Services Australia.

7. Retrieve Payment Item Details for Invoice Line Items

Next, Maica retrieves detailed payment data for each Invoice Line Item linked to the Claim Batch. This happens via the Payment Request records.

Again, no manual intervention is required here — it runs automatically behind the scenes.

What Maica does behind the scenes?

For every Invoice Line Item associated with the batch, Maica performs a callout to the Payment Item Reporting API. This API retrieves specific payment data for the corresponding Payment Item in Services Australia’s system.

  • The process starts by identifying the correct Invoice Line Item through the existing relationship with the parent Invoice, using the field maica__Invoice_Line_Item__c.maica__Aged_Care_Invoice_Item_ID__c.

  • All Invoice records linked to the batch are retrieved.

  • Maica then iterates through the related Invoice Line Items, matching each one against the returned ItemId from the API response.

  • When a match is found, Maica updates the associated Payment Request record with payment data returned by the API.

Relevant claim and contribution fields are mapped and stored as shown here.

After this step, each Invoice Line Item in Maica has been updated with precise payment data based on actual figures from Services Australia, and associated Payment Request records are also updated.

8. Refresh Care Recipient Budgets

As the final stage in the claiming workflow, this step ensures that your care recipients' budget records are up to date and reflect the processed and paid claims.

Note, this step is triggered automatically once Step 7 completes successfully.

To do so, Maica performs the following actions:

  • Identifies all unique Care Recipient IDs from the Invoice Line Items associated with the Claim Batch.

  • For each unique ID:

    • Sends a request to the Budgets API endpoint.

    • Retrieves current budget information and either creates or updates related:

      • Plan Budget records

      • Entitlement records

Only budgets where the End Date falls within 60 days of today are considered relevant and included in the refresh.

Once budget data has been refreshed, you will be well positioned to move forward with issuing any follow-up invoices for client contribution amounts not captured in the original claim, and the process is complete.

PreviousClaiming OverviewNextXero Integration Overview

Last updated

Was this helpful?