Working with the Macquarie Apigee system
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 type | SSA Notes | Novated Lease Notes |
---|---|---|
Individual | When 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 applicant | Not applicable. | Not applicable. |
Guarantor Rules
The table below shows the rules for guarantors;
Guarantor type | SSA Notes | Novated Lease Notes |
---|---|---|
Individual | Allowed. 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 applicant | Allowed | Not 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_PROPERTY | Own home property |
INVESTMENT_PROPERTY | Investment property |
CASH | Cash at bank |
SHARES_TRUSTS_FUNDS | Shares, |
MOTOR_VEHICLE | Motor Vehicle |
PLANT_AND_EQUIPMENT | Plant and Equipment |
SUPERANNUATION | Super |
RECREATIONAL_ASSET | Assets categories as Recreation Asset like boats, RV’s and Jet Ski |
HOME_CONTENTS | Home 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_LOAN | Own home property loan |
INVESTMENT_ PROPERTY_LOAN | Investment property loan |
MARGIN_LOAN | Margin loan |
MOTOR_VEHICLE_LOAN | Motor vehicle loan |
RECREATIONAL_ASSET_LOAN | Recreation asset loan |
PLANT_AND_EQUIPMENT_LOAN | Plant and Equipment loan |
INVESTMENT_LOAN | Loan for investments |
PERSONAL_LOAN | Personal loans |
CREDIT_CARD | Credit card |
OVERDRAFT | Overdraft |
DEBT_AGREEMENT | Debt agreement |
TAX_DEBT | Tax 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 Type | Asset Category | Finance type Supported | Min Term | Max Term | Min Finance Amount |
---|---|---|---|---|---|
Plant & Equipment | Fixed Wing (Other) | CM | 24 | 60 | 2,000.00 |
Plant & Equipment | Fixed Wing (Small, Med) | CM | 24 | 60 | 2,000.00 |
Plant & Equipment | Hybrid (Other) | CM | 24 | 60 | 2,000.00 |
Plant & Equipment | Hybrid (Small, Medium) | CM | 24 | 60 | 2,000.00 |
Plant & Equipment | Multi Rotor (Other) | CM | 24 | 60 | 2,000.00 |
Plant & Equipment | Multi Rotor (Small, Medium) | CM | 24 | 60 | 2,000.00 |
Plant & Equipment | Payload only | CM | 24 | 60 | 2,000.00 |
Plant & Equipment | Efficient Lighting | CM | 25 | 61 | 0 |
Plant & Equipment | Efficient Lighting | R | 24 | 36 | 0 |
Plant & Equipment | Energy - Other | CM | 1 | 61 | 0 |
Plant & Equipment | Energy Other | R | 24 | 60 | 0 |
Plant & Equipment | Solar Panels | CM | 1 | 84 | 0 |
Plant & Equipment | Solar Panel | R | 24 | 84 | 0 |
Plant & Equipment | Solar Panels | C | 25 | 60 | 0 |
Plant & Equipment | Solar Panels | C | 24 | 60 | 2,000.00 |
Plant & Equipment | Solar Panels | C | 24 | 60 | 2,000.00 |
Plant & Equipment | Audio & Visual Equipment | R | 24 | 60 | 0 |
Plant & Equipment | Laptops/Desktops/Tablets | R | 24 | 48 | 0 |
Plant & Equipment | Photocopiers | R | 24 | 60 | 0 |
Plant & Equipment | Point of Sale & Other IT | R | 24 | 60 | 0 |
Plant & Equipment | Printers | R | 24 | 60 | 0 |
Plant & Equipment | Security Equipment | R | 24 | 60 | 0 |
Plant & Equipment | Servers & Networking Equipment | R | 24 | 60 | 0 |
Motor Vehicle | Caravans & Campervans | C | 1 | 84 | 5,000.00 |
Motor Vehicle | Caravans and Campervans | CM | 1 | 61 | 5,000.00 |
Motor Vehicle | Motorcycles & Scooters | C | 1 | 61 | 0 |
Motor Vehicle | Motorcycles & Scooters | N | 1 | 61 | 0 |
Motor Vehicle | Motorcycles & Scooters | CM | 1 | 61 | 0 |
Motor Vehicle | Motorhomes | C | 1 | 84 | 5,000.00 |
Motor Vehicle | Motorhome | CM | 1 | 61 | 5,000.00 |
Plant & Equipment | Personal Watercraft | C | 1 | 84 | 0 |
Plant & Equipment | Personal Watercraft and Trailer | C | 1 | 84 | 0 |
Plant & Equipment | Trailer | C | 1 | 84 | 0 |
Plant & Equipment | Trailer Boat | C | 1 | 84 | 0 |
Plant & Equipment | Trailer Boat and Trailer | C | 1 | 84 | 0 |
Plant & Equipment | Air Conditioning | CM | 1 | 61 | 0 |
Motor Vehicle | Aircraft | CM | 1 | 61 | 0 |
Motor Vehicle | Aircraft used for Agricultural spraying | CM | 1 | 61 | 0 |
Plant & Equipment | Buildings | CM | 1 | 61 | 0 |
Plant & Equipment | Carriages | CM | 1 | 61 | 0 |
Plant & Equipment | Conveyors - Belts (Rubber or Vinyl) | CM | 1 | 61 | 0 |
Plant & Equipment | Conveyors - Rollers (Static or Movable) | CM | 1 | 61 | 0 |
Plant & Equipment | Injection Moulding | CM | 1 | 61 | 0 |
Plant & Equipment | Locomotives (Maclease) | CM | 1 | 61 | 0 |
Plant & Equipment | Other Broadcasting | CM | 1 | 61 | 0 |
Plant & Equipment | Poker Machines | CM | 1 | 61 | 0 |
Motor Vehicle | Watercraft | CM | 1 | 61 | 0 |
Motor Vehicle | Buses - Government Contract | CM | 1 | 61 | 0 |
Motor Vehicle | Buses - Other | CM | 1 | 61 | 0 |
Motor Vehicle | Cars - 30,000km+ p.a | N | 1 | 61 | 0 |
Motor Vehicle | Cars - Hire & Travellers | CM | 1 | 61 | 0 |
Motor Vehicle | Cars | N | 1 | 84 | 0 |
Motor Vehicle | Cars | C | 1 | 84 | 0 |
Motor Vehicle | Car | CM | 1 | 61 | 0 |
Motor Vehicle | Cars - Taxis | CM | 1 | 61 | 0 |
Motor Vehicle | Heavy Haulage - Local or Specialised | CM | 1 | 61 | 0 |
Motor Vehicle | Heavy Haulage - Long haul | CM | 1 | 61 | 0 |
Motor Vehicle | Light Commercial Vehicles - 30,000km+ p.a | N | 1 | 61 | 0 |
Motor Vehicle | Light Commercial Vehicles | N | 1 | 61 | 0 |
Motor Vehicle | Lorries & Trucks | CM | 1 | 61 | 0 |
Motor Vehicle | Trailers | CM | 1 | 61 | 0 |
Motor Vehicle | Utilities & Vans (< 1 tonne) - 30,000km+ p.a | N | 1 | 61 | 0 |
Motor Vehicle | Utilities & Vans (< 1 tonne) | N | 1 | 61 | 0 |
Motor Vehicle | Utilities & Vans | C | 1 | 84 | 0 |
Motor Vehicle | Utilities and Vans | CM | 1 | 61 | 0 |
Plant & Equipment | Agricultural - Other | CM | 1 | 61 | 0 |
Plant & Equipment | Bulldozers (Maclease) | CM | 1 | 61 | 0 |
Plant & Equipment | CNC Machines | CM | 1 | 61 | 0 |
Plant & Equipment | Commercial Cleaning Equipment | R | 24 | 60 | 0 |
Plant & Equipment | Cranes - Heavy over 15 tons | CM | 1 | 61 | 0 |
Plant & Equipment | Cranes - Light up to 15 tons | CM | 1 | 61 | 0 |
Plant & Equipment | Cranes - Tower (Maclease) | CM | 1 | 61 | 0 |
Motor Vehicle | Forklifts (Maclease) | CM | 1 | 61 | 0 |
Plant & Equipment | Generators/Welders/Plumbin g Equipment | R | 24 | 60 | 0 |
Plant & Equipment | Horticulture | R | 24 | 60 | 0 |
Plant & Equipment | Loaders & Skid Steers (Maclease) | CM | 1 | 61 | 0 |
Plant & Equipment | Material Handling | CM | 1 | 61 | 0 |
Plant & Equipment | Medical and Dental Equipment | CM | 1 | 61 | 0 |
Plant & Equipment | Medical & Dental Equipment | R | 24 | 60 | 0 |
Plant & Equipment | Other Earth Moving Equipment | CM | 1 | 61 | 0 |
Plant & Equipment | Printing | CM | 1 | 61 | 0 |
Plant & Equipment | Printing Equipment | R | 24 | 60 | 0 |
Plant & Equipment | Surveying Equipment | R | 24 | 60 | 0 |
Plant & Equipment | Tractors | CM | 1 | 61 | 0 |
Plant & Equipment | Woodworking Tools & Equipment | R | 24 | 60 | 0 |
Plant & Equipment | Workshop Equipment | R | 24 | 60 | 0 |
Plant & Equipment | Containers (Transportable) | CM | 1 | 61 | 0 |
Plant & Equipment | Electrical Equipment | CM | 1 | 61 | 0 |
Plant & Equipment | Fitouts, Furniture and Fittings | CM | 1 | 61 | 0 |
Plant & Equipment | Fitout, Furniture and Fittings | R | 24 | 60 | 0 |
Plant & Equipment | Laundry Equipment | CM | 1 | 61 | 0 |
Plant & Equipment | Office Equipment | CM | 1 | 61 | 0 |
Plant & Equipment | Other Computers | CM | 1 | 61 | 0 |
Plant & Equipment | Point of Sale Equipment | CM | 1 | 61 | 0 |
Plant & Equipment | Racks, storage & warehouse solutions | CM | 1 | 61 | 0 |
Plant & Equipment | Radio | CM | 1 | 61 | 0 |
Plant & Equipment | Refrigeration Assets (Excluding Transport) | CM | 1 | 61 | 0 |
Plant & Equipment | Scaffolding | CM | 1 | 61 | 0 |
Plant & Equipment | Servers (Maclease) | CM | 1 | 61 | 0 |
Plant & Equipment | Telephone Systems (Maclease) | CM | 1 | 61 | 0 |
Plant & Equipment | Television | CM | 1 | 61 | 0 |
Plant & Equipment | Testing Equipment | CM | 1 | 61 | 0 |
Plant & Equipment | Textile Manufacturing | CM | 1 | 61 | 0 |
Plant & Equipment | Vending/Amusement Machines | R | 24 | 60 | 0 |
Plant & Equipment | Tractors | C | 1 | 61 | 0 |
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.
- Click on the .
- Select Filter by Finacier - Macquarie.
- Select the relevant type,
- 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 Information | Apigee 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 name | This is mandatory when doing a Specific Security Agreement and “individual applicant”, “individual trustee” or “individual partner” are included on the application. |
Date of birth | Date 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:
When value = Own Outright or Mortgaged/Buying then an Own home property “financial_assets” type must be provided. |
Landlord name | The name of the landlord, maximum 32 characters, must be provided when residential status” is renting. |
Landlord phone | The contact number for the landlord must be provided when residential status” is renting. |
Previous address | Mandatory 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 Information | Apigee Rule |
---|---|
ABN | The ABN of the company the individual works at must be provided when
|
Employer name | The name of the current employer of the person must be provided if the employment type is ;
|
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;
|
Previous employer name | The 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 employed | Must 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;
|
Company Applicant Rules
Specific points that must be observed.
TFS Information | Apigee Rule |
---|---|
Accountant firm | Mandatory when the finance type is Specific Security Agreement and a company applicant”, company partner or company trustee is sent in the request. |
Accountant contact name | Mandatory when the finance type is Specific Security Agreement and a company applicant”, company partner or company trustee is sent in the request. |
Accountant contact phone | Mandatory when the finance type is Specific Security Agreement and a company applicant”, company partner or company trustee is sent in the request. |
ACN | This is mandatory |
Industry | This is mandatory (Set in the client overview screen) |
Telephone | You must supply a primary phone number. |
Address | You must supply the current registered address of the company. |
Trust Applicant Rules
Specific points that must be observed.
TFS Information | Apigee 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
|
Beneficiaries | Minimum of one beneficiary is required. |
Motor Vehicle Rules
Specific points that must be observed.
TFS Information | Apigee 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 Information | Apigee Rule |
---|---|
Supplier name | Mandatory maximum 150 characters |
Supplier address | Mandatory |
Settings, not support - Defaults Set
The following settings are not directly supported in TFS so we have set a default.
Apigee Value | TFS sets this too. |
---|---|
Citizen | |
We do not set anything |