Issue

We are making changes to the contribution-caps API which might affect your current integration. The changes will improve the performance of the API and provide the ability to record/retrieve prior-year concessional contributions for a take-on-fund. 

Resolution 

Question 1:

What are the changes that might affect the current mappings?

Answer 1: 

The below fields MemberContributionCapDetails, CalculatedFromPreviousYear will be removed in late November.

• TotalPreviousConcessional
• ExternalAccumulationBalance
• ExternalRetirementBalance
• ClassAccumulationBalance
• ClassRetirementBalance
• BalanceAdjustmentAmount
• PersonalInjuryBalance
• TotalClassSuperannuationBalance
• TotalExternalSuperannuationBalance
• TotalSuperannuationBalance

Question 2:

Will this change break my integration after the June release?

Answer 2: 

No, the current fields will be available and will be removed in November. There will be a duplication of information until then.

This will ensure the current integration is not affected and enabling you to have more time to migrate your mappings to the new object. 

Question 3:

Is there any new functionality available with the changes?

Answer 3: 

• A new object MemberYearBalanceDetail will available from the June release and will have the data fields that will be removed in November. Sample object:

  "MemberYearBalanceDetail": {
  	"ExternalAccumulationBalance": 7.0,
          "ExternalRetirementBalance": 8.0,
          "ClassAccumulationBalance": 9.0,
          "ClassRetirementBalance": 10.0,
          "BalanceAdjustmentAmount": 11.0,
          "PersonalInjuryBalance": 12.0,
          "TotalClassSuperannuationBalance": 18.0,
          "TotalExternalSuperannuationBalance": 15.0,
          "TotalSuperannuationBalance": 33.0
    } 

• New fields are available to view the previous concessional contributions made, TotalPreviousConcessional. This is only available for the year of the take on fund and will be null thereafter. These are new fields that will be available for mapping and will not affect any existing integrations. The values will be available only after 30/06/2020 as the functionality to record will be turned on as part of the new financial year. Sample object:

  "TotalPreviousConcessional": [
  	{
  	  "FinancialYear": 1,
  	  "Amount": 1.0
  	},
  	{
  	  "FinancialYear": 2,
  	  "Amount": 2.0
  	},
  	{
  	  "FinancialYear": 3,
  	  "Amount": 3.0
  	},
  	{
  	  "FinancialYear": 4,
  	  "Amount": 4.0
  	},
  	{
  	  "FinancialYear": 5,
  	  "Amount": 5.0
  	}
  	 ]
    }

Question 4:

How can I test the changes?

Answer 4: 

The changes are not available in production until the June release. To assist you in testing, the changes will be made available in our Partner Integration Environment (PIE) once the changes are ready. We will notify you once the changes are in the Partner Integration Environment (PIE).