ISC Developer Portal

Status Codes

When interacting with the NLIS API, your system will receive an HTTP Response code to indicate whether or not you have interacted with the API successfully, or if an error has occurred. The Response code can be used to determine what corrective action (if any) is needed.

For more information about HTTP Response codes, please see http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.

The HTTP Response header received will contain an HTTP Response code, containing one of the following codes:

HTTP Response Code HTTP Request Type Resource/Collection Description
200 OK

GET, PUT, DELETE

GET, POST

Resource

 

Collection

The default success code for requests that return a valid response in the response body, even if the response does not contain any rows or pagination.

When POST-ing a new record a 200 indicates that while the request was correctly processed the record may not have been accepted, the body of the Response will indicate the reason for this error.

201 Created POST Collection

Success code for a POST request for a collection, indicating the record was successfully created. Note: While a 201 indicates the record was recorded, there may be Informational or Warning messages (in the Response body) that may require some corrective action to occur.

304 Not Modified Conditional GET Either

The request content has not changed since a specified date and time (provided in an If-Modified-Since parameter in the request).

400 Bad Request GET Either

The data passed in the request could not be understood, or translated to into an internal format.

Typically, the passed message fails simple type validation rules (e.g. passing a string when a number is expected), or document structure rules (e.g. is a malformed XML or JSON document).

401 Unauthorized

GET, PUT,
POST,
DELETE

Either

This error is returned when the OAuth token used has expired or is invalid; the user attempts to perform an action for which they are not authorized; or if a login attempt fails due to bad credentials.

403 Forbidden GET, PUT, POST, DELETE Either Authentication was provided, but the authenticated user is not permitted to perform the requested operation.
404 Not Found GET Resource

The requested resource could not be found.

This error is generally returned when an entity with a specific ID is not found in our database. Check the URI for correct format, and that any IDs passed in the URI are valid.

500 Internal Server Error

GET, PUT,
POST,
DELETE

Either

Any internal server error that was not explicitly trapped by the application. An error has occurred within the platform, or the system is not compatible with the NLIS API, so the request could not be completed.

Contact the NLIS Development Team at technicalsupport@IntegritySystems.com.au for assistance with this error.

Error Codes

Error code range

  • Error codes 1000 - 1999: NVD system-related
  • Error codes 2000 - 2999: NVD endpoint-related
  • Error codes 3000 - 3999: NLIS user-related
  • Error codes 4000 - 4999: Vendor declaration-related

Error Codes

Code Text

1004

An unexpected error has occurred on this page. The system administrators have been notified. Please feel free to contact envdsupport@mla.com.au with the information surrounding this error.

1005

You are not allowed to access the resource.

3005

You are not authorized to create NVDs

3006

You are not authorized to recreate NVDs

3007

You are not authorized to update NVD saleyard data

3008

You are not authorized to cancel NVDs

3009

You are not authorized to update NVDs Quantities

3010

You are not authorized to retrieve NVDs

3011

Answer type validator is not available.

The system administrators have been notified. Please feel free to contact envdsupport@mla.com.au with the information surrounding this error.

3013

You are not authorized to lookup PIC (<requestedPIC>)

3017

You are not authorised to update transporter details.

4000

PIC or State or last name or property name must be provided

4001

Invalid Format

4002

The NVD serial number cannot be empty

4003

The schema version number (<submittedVersion>) is not the latest

4010

The NVD serial number (<requestSerialNumber>) does not exist

4019

PIC (<submittedPIC>) does not exist in NLIS

4022

(<requiredField>) cannot be empty

4023

The schema version number cannot be empty

4024

Schema reference is unknown

4025

The vendor declaration data Id cannot be empty

4027

(<submittedFieldValue>) is in the incorrect format

4029

The schema version number (<submittedSchemaVersionNumber>) does not exist in NLIS system

4030

The NVD reference number (<submittedReferenceNumber>) already exists

4031

Repeater Control ID is not in the correct format (Refer to the Developer Schema guide for more information)

4032

No vendor declaration has been submitted

4034

The file exceed the allowed maximum file size (5MB)

4035

Please provide a valid file

4036

The file type is not allowed (allowed file types are jpg, gif, tif, png and pdf)

4037

There are no files attached to the vendor declaration data ID (<fileTypeField>)

4038

You cannot insert saleyard data using NVD create

4041

No vendor declaration data has been provided

4042

The following data must not be answered unless their conditional questions are satisfied: (<incorrectConditionalField>)

4043

No schema for the requested schema reference (<submittedSchemaReference>) and date (<requestedDate>)

4044

You are not authorized to delete file (<fileGUID>)

4045

You cannot update other than Qty

4050

Consignor PIC is required

4051

Consignee PIC is required

4054

The file (<fileGUID>) does not exist in eNVD archive system

4055

Auction buyer PIC is required

4056

PIC is required

4057

Invalid value specified for fields.

4058

SerialNumber must not be supplied. Use ReferenceNumber instead.

4059

The NVD has been locked. Please contact NLIS Help Desk to unlock the NVD.

4060

Provided <accountType> (<accountID>) is not a valid NLIS AccountID.

4061

<accountType> <accountID> is not linked with PIC <PIC>

4062

The NVD NLIS owner account ID can be provided only for paper NVD.

4063

At least one search parameter (PIC, name, town, state etc) must be provided.

4064

The NVD NLIS owner account ID can be provided only for paper NVD.

4065

At least one search parameter (Serial Number, Reference Number, Schema Reference ID, Date From, Date To) must be provided.

4067

The <AccountType> PIC (<PIC>) must be associated with an NLIS account to ensure the eNVD can be retrieved. This eNVD has not been updated.

4068

The declaration date cannot be more than <ANumberOfDays> after the eNVD creation date. This eNVD has not been created.

4069

Date should be in the past.

4070

<accountType> (<accountID>) does not have software to receive eNVDs This request has not been successful.

4071 Users linked to Consignee/Destination/SaleBuyer PIC (<Consignee/Destination/Salebuyer PIC>) do not have software to receive eNVDs. This request has not been successful.
4072 This eNVD has been locked by AccountID (<accountID>). This request has not been successful.
4073 You are not authorized to lock or unlock this eNVD . This request has not been successful.
4074 This eNVD has been unlocked by AccountID (<accountID>). This request has not been successful.
logo Integrity Systems Company