MacLease Interface: Partner Interface

MacLease partner interface setup and troubleshooting

Partner Interface

The Maclease Partner interface supercedes the old Maclease interface, by sending a JSON file instead of a xml file. More data is now required to be sent to Maclease to complete a successful transfer of data.

Catch-e fields have been mapped to specified Maclease fields to enable this. The spreadsheet attached identifies all optional(O), conditional(O*) and mandatory(M) type fields.

For information on the older Maclease Interface click here.

Making an Application

When the financier selected in the quote's ‘Financier’ field has an interfacetype = ‘macleasepartner’, you will see a prompt appear advising of the requirement to have the Drivers / Assets & Liabilties tab populated. The Assets and Liabilities sections under the Drivers / Finance screen are no longer being mapped into Maclease. If values are added, these will be ignored and validations will be relevant to entries the Assets & Liabilities tab. All other previous validations still apply and need to be resolved for a successful application.

When your organisation has been configured for the Maclease Partner interface, the "Apply" button becomes available on the Quotes/Finance tab to transfer data from Catch-e direct to MacLease. This will enable a finance application to be created and picked up by Maclease for approval.

When the data transfer has been successful, Catch-e will store the Maclease reference number in "Application Reference" along with the date and time the application was made. The "Status" will be updated to 'Successful'. If the transfer has not been successful, the "Status" will be updated as 'Failed'. Investigation as to why this has occurred my be needed from either Maclease and/or Catch-e users.

By changing the "Status" to 'Resubmit', another application can be made against the same quote. A new "Application Reference" will be supplied and recorded. You will need to log into Maclease to terminate the original application reference.

A copied quote will retain the "Application Reference". To make a separate application for a copied quote, edit the Status field to 'Resubmit' and the "Apply" button will appear. You can login to Maclease to view and edit the application if required.

Missing "Apply" Button

When the Maclease Partner interface has been configured and the "Apply" button is not available, consider the following;

  1. The Financier must be set to Macquarie Leasing
  2. The status of the Finance Application must not be 'Successful'
  3. The Contract Type Group must be "Novated"
  4. A driver (driver_id) must be allocated to the quote

Troubleshooting Errors

Types of errors that can be encountered during the Application process;

  1. Interface failure
  2. Validation errors
  3. Application failures
  4. Total Finance Payment Calculation error

Interface failure

Where an application cannot be submitted it may be because of one of the following reasons;

  1. A communication error between systems. Contact your Maclease and/or Catch-e Account Manager for further information.
  2. The Rate Plan that your organisation has been set up with by Maclease.
    To use the Maclease Partner API interface via Catch-e, you must be set up as an Introducer with a Rate Plan equal to Default Plan. If not, you must make submissions via the Maclease Application direct, as it will fail via Catch-e.

Validation errors

Validation errors are typically produced because information which is deemed mandatory by Maclease is missing or all conditions linked to a specific field have not been met and need to be added or adjusted.

Users will be prompted via a pop up screen alerting them to the specific fields which need attention prior to an application being made.

Please refer to the Validation Error list to address any errors.

Application failures

When an application fails it is because the request being sent has not been received by Maclease.

If this occurs, please contact your Account Manager at Macquarie Leasing.

Alternatively, contact Catch-e and we can review each application via the gbwebservice_log table.

Use of Originator Fee

The inclusion of an Originator Fee for a Macquarie Leasing application is treated in a unique way.

In Maclease the Originator Fee is passed in as an ex GST value by taking the / (1+ Then Maclease adds in the GST, the gross value of the Originator Fee is added into the amount financed to determine the monthly rental.

Where the 'Apply' feature for Maclease is used and an Originator Fee is included that value should be entered into the quote as a GST inclusive value i.e. $550.00 inc GST is taken into Maclease as $500.00.

Total Finance Payment Calculation error

The reason this error appears is due to the calculated gross payment value in Catch-e does not match the Maclease quote engine's calculation.

Error message;

Total Finance Payment Calculation: Please confirm value in the following field:* Monthly Payments Fee

Reason will be one of the following;

  • The 'Financier Monthly Administration Fee' has been included in the Catch-e quote, but not applied in the Maclease application, or vice versa. Please contact your Maclease Account Manager to confirm if this fee is applicable, and if it has been set up to have it calculated into your quotes. If it does apply, it is required to be added as a Fee in 'qtfinancierpostingmapdefaults' in Catch-e.
  • There is a mis-match between the 'Total Finance Payment' amount between Catch-e and Maclease. This is sometimes due to a rounding calculation of 1 to 2 cents that causes the application to fail. Catch-e and Maclease are continuing to work through this issue to pinpoint exactly which calculation is causing the error to be triggered. Please use the 'Print' button on the [Quote:Finance|Quote / Finance tab and export and forward the JSON on to Catch-e Support so we can investigate the issue. Do not make any changes to quote prior to sending through the JSON file.

To troubleshoot if an error occurs, you can use the following calculator to determine what value Maclease is expecting to Catch-e to submit via the API.

  • Enter the values in the section Catch-e Gross Payment Calculation from the Quotes / Finance Tab.

  • Enter the values in the section Maclease Gross Payment Calculation from the JSON Payload Output. You can export this using the Print button. The values you require are in the last section labelled "quotation".