MacLease Interface: Partner Interface Validation Errors — Maclease Generated Validation Errors
MacLease partner interface setup and troubleshooting
Maclease Generated Validation Errors
The following table identifies the Maclease validation errors and to how resolve them to pass a successful application. These errors will appear once all Catch-e validations have been met.
A few of the errors listed below do not apply to the type of application being passed out of Catch-e, but it is a complete list of the validation errors provided by Maclease.
If you receive an error not specified in the list(s) below, please contact your Maclease Account Manager to assist in identifying why it is failing.
| ASSETLISTGTMAXIMUM | A rule to restrict the number of assets per application | | assetsubtypecode:ASSETSUBTYPE_INVALID | Invalid asset sub type. The following asset sub types have been decommissioned by Macquarie Leasing Passenger Vehicles over 30,000klms p.a. as at 01/03/2022. Light Commercial Vehicles as at 01/08/2022. Troubleshooting The quoted vehicle is for a Novated Lease and falls into the following category, as defined by Maclease. A full list of these Asset sub type definitions and what is accepted can be referenced here.
* "MOTOVCARS-30,000KMP.A_AU"
* "Light Commercial Vehicles - 30,000 KM + p/a"
* "Utilities and Vans - 30,000 KM + p/a"
To troubleshoot the asset type category, you will need to print the JSON file using the 'Print' button from the Quotes / Finance tab. The image below shows where the selected Asset sub type is located in the JSON file.
The Asset sub type is not stored in Catch-e. It is a hard-coded mapped value based on the Vehicle Type in the Variant Profile. |
| ASSETTOTALMISMATCH | The asset cost in quotation does not match the total cost of all assets in the request. |
| ATLEASTONEREQUIRED | At least one value of a related group should be provided (e.g. one of home, mobile and work phone numbers should be provided). || BASISNOTSUPPORTEDFORPAYMENTFREQUENCY | The basis provided is not supported for the payment frequency provided. |
| CANNOTEXCEEDMAXEFFECTIVERATE | The effectiverate of the quotation exceeds the maximum threshold. || CASHDEPOSITTRADEINGTASSETCOST | The value of cashdeposit + tradein is greater than assetcost. |
| DATEINVALID | Invalid date value. || DECIMALSCALEGTMAXALLOWED | Decimal value contains more than the allowed precision (e.g. 3 or more decimal places for currency amounts) || DEFFEREDMONTHSNOTALLOWEDFORARREARS | The value of deferredmonths is not applicable for the given basis value. || DOBLESSTHANMINIMUMAGE | Less than minimum age by the given date of birth. || DUPLICATEDOCUMENTFORDOCCLASS | The maximum number of uploads has been reached per document class. || EMPTYLIST | No value is specified in a collection whilst at least one is expected (e.g. an empty array for applicant objects) |
| financetype: NOTSUPPORTED | Your login credentials do not support the financetype of the application. Check your login details with Maclease. || equipmentlocation: EXCEEDSLENGTHLIMIT | 'equipmentlocation' is the Maclease field name for driver's home address. 'Address1, Address2, Area, State, Postcode' must be no more than 50 characters in length. Shorten the address. For example : 'Street' could become 'St'. || EXCEEDSLENGTHLIMIT | A property value length exceeds the maximum allowed length - predominantly for text values. || EXCEEDSMAXCOUNT | Occurrence in the request exceeds maximum threshold expected by the system. || EXCEEDSMAXTHRESHOLD | Brokerage Value concluded exceeds the maximum brokerage allowed. Please reduce the brokerage value or the customer rate in the quotation element. If you are unsure as to what the maximum allowable brokerage is, please contact your Maclease Account Manager. || FINANCETYPENOTSUPPORTEDFORSELECTEDASSETSUBTYPE | The current finance type is not supported by the selected asset sub type. || GREATERTHANASSETCOST | The value cannot be greater than asset cost. |
| GREATERTHANMAXIMUM | A numeric value is greater than the maximum allowed value. |
| GSTONASSETCOSTGTMAXALLOWED | The value of assetcostgst is more than 1/11 of assetcost. || INCORRECTLENGTH | Incorrect length of the field value. |
| INFORMATIONMISMATCH | The field value returned is incompatible with a linked field value || INSURANCEINVALIDFORASSETSUBTYPE | Invalid insurance for the given asset subtype. || INSURANCENOTSUPPORTED | As at 01 July 2020, Maclease will no longer support the inclusion of any Insurance value in their financed product. If you encounter this error, please remove all insurance products from your quote application. || INSURANCEPOLICYEXCEEDSMAXTERM | Insurance policy exceeds the maximum term allowed. | | INVALID | If the Drivers / Contact "Licence Card Number" is blank, this error will be returned. The field requires a maximum of 20 characters - alpha numeric with no special characters. This field is mandatory. Where a submission is made and "Licence Card Number" does not have a value, the application will fail and show the error. This will be effective as at 15/03/2023. || INVALIDDOCUMENTUPLOADCLASSTYPE | Document class provided is not valid. || INVALIDINSURERORINSURANCETYPE | Mismatch between the given insurer and insurance type. || INVALIDPROPERTYVALUE | Invalid value for option-based fields || INVALIDQUOTATIONGROSSPAYMENTVALUE | The quotation gross payment value does not match Maclease's quote engine’s calculation. || LESSTHANMINIMUM | A numeric value is less than the minimum allowed value. || MANUALINSURERTOTALNOTEQUALTOQUOTATION | The total amount of the manual insurance does not match the insurance value of the quotation. || MORETHANONEAPPLICANTCLASSPROVIDED | More than one applicant type was provided in the application. |
| MORETHANONEASSETCLASSPROVIDED | More than one assetsubtype is provided for the application. |
| MORETHANONEGUARANTORCLASSPROVIDED | More than one guarantor type is provided. || MORETHANONEPARTNERCLASSPROVIDED | The partnership applicant contains more than one partner type. |
| MUSTBEGTZERO | A numeric value greater than 0 is required. || MUSTBENULL | A NULL value is expected in the stated field || NORATECARD | Rate card not configured for finance and asset type sent, reach out to Macquarie for rate card configuration |
| NOTALLOWED | Input is not allowed for the application. || NOTNUMERIC | A non numeric value was provided for a numeric field. |
| NOTSUPPORTEDFORSELECTEDASSETSUBTYPE | The given field value is not supported by the current assetsubtype. |
| NOTSUPPORTEDWITHSELECTEDSOLVEFOR | The given field value is not supported by the current solvefor method |
| NUMASSETONLYONEALLOWED | More than one asset type was specified in the application. |
| OWNRATEGREATERTHANEFFECTIVERATE | The ownrate is greater than the effectiverate which is not allowed. || PHONEFORMATINVALID | The provided phone number is invalid. || PROMOTIONALREADYEXPIRED | A promotion is expired/disabled/deactivated. || PROMOTIONYETTOSTART | A promotion is yet to start in a future date. |
| REQUIRED | The value of a mandatory field is missing. |
| REQUIREDRATECARD | This is a mandatory field for computation of rate. || residualvalue:GREATERTHANMAXIMUM | The submitted residual value in the quote request is outside MQ configured threshold. |
| residualvalue:LESSTHANMINIMUM | The submitted residual value in the quote request is outside MQ configured threshold. || saletype.NOTSUPPORTED | The selected "Finance Type" on the Quotes / Finance tab is no longer a valid Maclease option for Novated Lease quote applications. || UNREADABLEINPUT | The JSON input is invalid. |
| UNSUPPORTEDMEDIATYPE | The file type is not supported. |
| USERNOTAUTHORISED | The user/password provided in the HTTPS Header is not valid or authorised to submit the application. |
| YOUNGERTHANMINIMUM_AGE | Age is less than 18 years old. |
Solving the Maclease Validation Error
The listed error messages above typically appear as a suffix in the error displayed, with the prefix identifying the Maclease Element causing the issue.
The identified Maclease Element can be found in the JSON file. This can be produced by selecting 'Print' from the Quotes / Finance Tab.
For example, the following error is displayed on 'Apply':
Go to the exported JSON file from the quote. Based on the error reading 'REQUIRED', it implies the data is missing. 'State' and 'Postcode' are associated with addresses, therefore you will be looking for an 'address' element that is missing these descriptions.
Return to the Drivers / Finances tab and enter the missing data.
Once saved and no other errors are triggered, the application will be successful.
This is only one of many Maclease errors that can be triggered. If you apply the prefix:suffix logic that is displayed in the error, you will be able to navigate through the potential validation errors.