/
Working with the Macquarie Apigee system

Working with the Macquarie Apigee system


Click the logo to return to KB


The Finance Shop Release Notes

     

        

This article explains the rules that Macquarie impose when submitting deals electronically to their new Apigee system.

Due to restrictions of the Macquarie system, currently, you can only submit the following application types through to the Apigee system from TFS;

  • Specific Security Agreement - Chattel Mortgage.
  • Novated Lease.

Macquarie is not making rental available for electronic submission.

If you need to submit an application that falls outside the parameters listed in this article then, unfortunately, you will have to enter it manually. 

If you try and submit a different type of application you will receive a message 

YOU SHOULD USE THE RATES AS DETAILED IN YOUR COMMERCIAL RATE BULLETIN DOCUMENT. IF YOU DO NOT USE THE CORRECT RATE YOU MAY SEE THE FOLLOWING ERROR

YOU CANNOT SUBMIT GROUP OR CUSTOM PAYMENT STRUCTURES. THIS IS A MACQUARIE RESTRICTION

If you try and submit a non Single Payments structure you will receive the following message.


Supported Applicant and Application Types

The table below shows the types of application and applicants that the Macquarie Apigee system accepts.

Applicant typeSSA NotesNovated Lease Notes
IndividualWhen the applicant is of the type of individual applicant only 1 individual applicant is allowed for the application.The applicant must be an individual when doing novated leases.
Company The company can only be the applicant when doing SSA applications.Not applicable.
Trust Not applicable.Not applicable.
Partnership applicantNot applicable.Not applicable.

Guarantor Rules

The table below shows the rules for guarantors;

Guarantor typeSSA NotesNovated Lease Notes
IndividualAllowed. When the applicant is of the type of individual applicant only 1 individual applicant is allowed for the application.Not applicable.
Company Allowed.Not applicable.
Trust Allowed.Not applicable.
Partnership applicantAllowedNot applicable.

Assets and Liabilities

The Apigee system only supports a specific group of assets and liabilities. The tables below show the available types.

Macquarie Financial Asset Type
TFS Description
HOME_PROPERTYOwn home property
INVESTMENT_PROPERTYInvestment property
CASHCash at bank
SHARES_TRUSTS_FUNDSShares,
MOTOR_VEHICLEMotor Vehicle
PLANT_AND_EQUIPMENTPlant and Equipment
SUPERANNUATIONSuper
RECREATIONAL_ASSETAssets categories as Recreation Asset like boats, RV’s and Jet Ski
HOME_CONTENTSHome Contents

When choosing the Asser Category use the Filter by Financier to see the relevant codes;

Unfortunately, this displays Application Goods categories as well so you will have to ensure that the asset category is in the table above.

The Primary Income record should be added by completing an employment record for the contact.

The supported liabilities are listed below;

Macquarie Financial Liability Type
TFS Description
HOME_PROPERTY_LOANOwn home property loan
INVESTMENT_ PROPERTY_LOANInvestment property loan
MARGIN_LOANMargin loan
MOTOR_VEHICLE_LOANMotor vehicle loan
RECREATIONAL_ASSET_LOANRecreation asset loan
PLANT_AND_EQUIPMENT_LOANPlant and Equipment loan
INVESTMENT_LOANLoan for investments
PERSONAL_LOANPersonal loans
CREDIT_CARDCredit card
OVERDRAFTOverdraft
DEBT_AGREEMENTDebt agreement
TAX_DEBTTax debt

When choosing the liability category you can filter down to the specific ones for Macquarie;

In addition to the Liabilities, you can also define a contacts expenses. 

Address Requirements

You will need to supply full addresses for the following entities;

Private Sale

Phone Number Requirements

When entering landline numbers they must include the state code and no spaces e.g 0385744800.

When entering mobile numbers they must not have any spaces e.g 0491570156.

If they are not entered in this format the submission will be rejected.

Supported Application Goods Types and Rules

When adding goods records to an application they must be from one of the types and categories listed below. All of them belong to one of two asset types which are Plant & Equipment or Motor Vehicle.

e.g. 

The table below shows the Asset Type and Asset Category options that you can select on applications that you want to submit to the Macquarie Apigee system. It also details the finance types you can use them as well as minimum and maximums on terms and amounts

CM = SSA
C = Consumer loan (Not supported from TFS)
R = Rental (Not supported via electronic submission to Apigee.)
N = Novated Lease

Asset TypeAsset Category Finance type 
Supported
Min
Term 
Max
Term
Min
Finance Amount
Plant & EquipmentFixed Wing (Other) CM 24602,000.00
Plant & EquipmentFixed Wing (Small, Med) CM 24602,000.00
Plant & EquipmentHybrid (Other) CM 24602,000.00
Plant & EquipmentHybrid (Small, Medium) CM 24602,000.00
Plant & EquipmentMulti Rotor (Other) CM 24602,000.00
Plant & EquipmentMulti Rotor (Small, Medium) CM 24602,000.00
Plant & EquipmentPayload only CM 24602,000.00
Plant & EquipmentEfficient Lighting CM 25610
Plant & EquipmentEfficient  Lighting 24360
Plant & EquipmentEnergy - Other CM 1610
Plant & EquipmentEnergy Other 24600
Plant & EquipmentSolar Panels CM 1840
Plant & EquipmentSolar Panel 24840
Plant & EquipmentSolar Panels 25600
Plant & EquipmentSolar Panels 24602,000.00
Plant & EquipmentSolar Panels 24602,000.00
Plant & EquipmentAudio & Visual Equipment 24600
Plant & EquipmentLaptops/Desktops/Tablets 24480
Plant & EquipmentPhotocopiers 24600
Plant & EquipmentPoint of Sale & Other IT 24600
Plant & EquipmentPrinters 24600
Plant & EquipmentSecurity Equipment 24600
Plant & EquipmentServers & Networking Equipment 24600
Motor VehicleCaravans & Campervans 1845,000.00
Motor VehicleCaravans and Campervans CM 1615,000.00
Motor VehicleMotorcycles & Scooters 1610
Motor VehicleMotorcycles & Scooters 1610
Motor VehicleMotorcycles & Scooters CM 1610
Motor VehicleMotorhomes 1845,000.00
Motor VehicleMotorhome CM 1615,000.00
Plant & EquipmentPersonal Watercraft 1840
Plant & EquipmentPersonal Watercraft and Trailer1840
Plant & EquipmentTrailer 1840
Plant & EquipmentTrailer Boat 1840
Plant & EquipmentTrailer Boat and Trailer 1840
Plant & EquipmentAir Conditioning CM 1610
Motor VehicleAircraft CM 1610
Motor VehicleAircraft used for Agricultural spraying CM 1610
Plant & EquipmentBuildings CM 1610
Plant & EquipmentCarriages CM 1610
Plant & EquipmentConveyors - Belts (Rubber or Vinyl) CM 1610
Plant & EquipmentConveyors - Rollers (Static or Movable) CM 1610
Plant & EquipmentInjection Moulding CM 1610
Plant & EquipmentLocomotives (Maclease)CM 1610
Plant & EquipmentOther Broadcasting CM 1610
Plant & EquipmentPoker Machines CM 1610
Motor VehicleWatercraft CM 1610
Motor VehicleBuses - Government Contract CM 1610
Motor VehicleBuses - Other CM 1610
Motor VehicleCars - 30,000km+ p.a 1610
Motor VehicleCars - Hire & Travellers CM 1610
Motor VehicleCars 1840
Motor VehicleCars 1840
Motor VehicleCar CM 1610
Motor VehicleCars - Taxis CM 1610
Motor VehicleHeavy Haulage - Local or Specialised CM 1610
Motor VehicleHeavy Haulage - Long haul CM 1610
Motor VehicleLight Commercial Vehicles - 30,000km+ p.a 1610
Motor VehicleLight Commercial Vehicles 1610
Motor VehicleLorries & Trucks CM 1610
Motor VehicleTrailers CM 1610
Motor VehicleUtilities & Vans (< 1 tonne) - 30,000km+ p.a 1610
Motor VehicleUtilities & Vans (< 1 tonne) 1610
Motor VehicleUtilities & Vans 1840
Motor VehicleUtilities and Vans CM 1610
Plant & EquipmentAgricultural - Other CM 1610
Plant & EquipmentBulldozers (Maclease)CM 1610
Plant & EquipmentCNC Machines CM 1610
Plant & EquipmentCommercial Cleaning Equipment 24600
Plant & EquipmentCranes - Heavy over 15 tons CM 1610
Plant & EquipmentCranes - Light up to 15 tons CM 1610
Plant & EquipmentCranes - Tower (Maclease) CM 1610
Motor VehicleForklifts (Maclease) CM 1610
Plant & EquipmentGenerators/Welders/Plumbin g Equipment 24600
Plant & EquipmentHorticulture 24600
Plant & EquipmentLoaders & Skid Steers (Maclease) CM 1610
Plant & EquipmentMaterial Handling CM 1610
Plant & EquipmentMedical and Dental Equipment CM 1610
Plant & EquipmentMedical & Dental Equipment 24600
Plant & EquipmentOther Earth Moving Equipment CM 1610
Plant & EquipmentPrinting CM 1610
Plant & EquipmentPrinting Equipment 24600
Plant & EquipmentSurveying Equipment 24600
Plant & EquipmentTractors CM 1610
Plant & EquipmentWoodworking Tools & Equipment 24600
Plant & EquipmentWorkshop Equipment 24600
Plant & EquipmentContainers (Transportable) CM 1610
Plant & EquipmentElectrical Equipment CM 1610
Plant & EquipmentFitouts, Furniture and Fittings CM 1610
Plant & EquipmentFitout, Furniture and Fittings 24600
Plant & EquipmentLaundry Equipment CM 1610
Plant & EquipmentOffice Equipment CM 1610
Plant & EquipmentOther Computers CM 1610
Plant & EquipmentPoint of Sale Equipment CM 1610
Plant & EquipmentRacks, storage & warehouse solutions CM 1610
Plant & EquipmentRadio CM 1610
Plant & EquipmentRefrigeration Assets (Excluding Transport) CM 1610
Plant & EquipmentScaffolding CM 1610
Plant & EquipmentServers (Maclease) CM 1610
Plant & EquipmentTelephone Systems (Maclease) CM 1610
Plant & EquipmentTelevision CM 1610
Plant & EquipmentTesting Equipment CM 1610
Plant & EquipmentTextile Manufacturing CM 1610
Plant & EquipmentVending/Amusement Machines 24600
Plant & EquipmentTractors 1610

Sale Type

This is a new mandatory requirement that must specify for every transaction that you are submitting to Macquarie. This is done by setting the Purpose field in the New Application or Application Overview screen. Use the Filter by Financier option to quickly see the codes that are available.

  1. Click on the .
  2. Select Filter by Finacier - Macquarie.
  3. Select the relevant type,
  4. Click on OK.



It can be one of the following values only;

  • Dealer with ABN
  • Private no ABN
  • Private with ABN
  • Refinance Macq
  • Refinance
  • Sale and  Buyback

Individual Rules

When submitting deals that include the following;

  • Individual applicant.
  • Individual guarantor
  • Business_person
  • Individual trustee
  • Individual partner

The following rules apply.

TFS InformationApigee Rule
Accountant contact name

This is mandatory when doing a Specific Security Agreement and “individual applicant”, “individual trustee” or “individual partner” are included on the application.

Accountant contact phone This is mandatory when doing a Specific Security Agreement and “individual applicant”, “individual trustee” or “individual partner” are included on the application.
Accountant firm nameThis is mandatory when doing a Specific Security Agreement and “individual applicant”, “individual trustee” or “individual partner” are included on the application.
Date of birthDate of birth of Individual must be at least 18 years old.
Residential status

The residential status of the person. Must be one of the following values: 

  • Own Outright
  • Mortgaged/Buying
  • Live With Parents 
  • Board
  • Rent 

When value = Own Outright or Mortgaged/Buying then an Own home property  “financial_assets” type must be provided.

Landlord nameThe name of the landlord, maximum 32 characters, must be provided when residential status” is renting.
Landlord phoneThe contact number for the landlord must be provided when residential status” is renting.
Previous addressMandatory if the individual has been residing at the current residential for less than two years.


Employment Details Rules

Specific points that must be observed.

TFS InformationApigee Rule
ABN 

The ABN of the company the individual works at must be provided when

  • The finance type is Specific Security Agreement   and sole trader value is “YES” 
  • The finance type is Novated Lease.
Employer name 

The name of the current employer of the person must be provided if the employment type is ;

  • Casual.
  • Full Time.
  • Part Time
Business Activity
This must be provided when the finance type is Specific Security Agreement and Is Sole Trader is Yes

Employment type

Must be one of the following values;

  • Casual
  • Casual Part Time
  • Full Time
  • Part Time
  • Self employed
  • Pensioner


Previous employer nameThe name of the previous employer. Need to be provided if the individual has been with the current employer for less than 2 years.
Previous years employedMust be provided if the individual has been with the current employer for less than 2 years. 
Employer address

Must be provided when employment types is;

  • Casual
  • Casual Part Time
  • Full Time
  • Part Time

Company Applicant Rules

Specific points that must be observed.

TFS InformationApigee Rule
Accountant firmMandatory when the finance type is Specific Security Agreement and a company applicant”, company partner or company trustee is sent in the request. 
Accountant contact nameMandatory when the finance type is Specific Security Agreement and a company applicant”, company partner or company trustee is sent in the request. 
Accountant contact phoneMandatory when the finance type is Specific Security Agreement and a company applicant”, company partner or company trustee is sent in the request. 
ACNThis is mandatory
IndustryThis is mandatory (Set in the client overview screen)
TelephoneYou must supply a primary phone number.
AddressYou must supply the current registered address of the company.

Trust Applicant Rules

Specific points that must be observed.

TFS InformationApigee Rule
Activity / Purpose
Use the Notes field on the Trust entity to define this.
The activity purpose of the trust. 
Trust type

Can be one of the following

  • Family.
  • Trading.
  • Property
BeneficiariesMinimum of one beneficiary is required.

Motor Vehicle Rules

Specific points that must be observed.

TFS InformationApigee Rule
Body type.

This field is optional but if supplied must be one of the following options available by filtering to MAcquarie


Make

The make of the vehicle must be one of the one the options available by filtering to Macquarie

Model

The model of the motor vehicle maximum 78 characters.

An empty string is allowed

Not required when finance type is Novated Lease.

Supplier Rules

Specific points that must be observed when sending supplier information

TFS InformationApigee Rule
Supplier nameMandatory maximum 150 characters
Supplier addressMandatory

Settings, not support - Defaults Set

The following settings are not directly supported in TFS so we have set a default.


Apigee ValueTFS sets this too.

Citizen

We do not set anything